---
title: "Conta Azul OAuth token renewal errors provide specific causes: 2026-09-15 | Harbyn"
description: "Conta Azul OAuth token renewal errors provide specific causes, announced Sep 15, 2026."
canonical: "https://harbyn.com/changes/contaazul/2026-09-15-oauth-token-renewal-errors-provide-specific-causes"
last-updated: 2026-09-29
---

# Conta Azul OAuth token renewal errors provide specific causes

Markdown version of <https://harbyn.com/changes/contaazul/2026-09-15-oauth-token-renewal-errors-provide-specific-causes>.

Behavior change - Conta Azul. medium severity. Announced.

Errors from POST api-v2.contaazul.com/oauth/token now include error\_subtype with values access\_revoked, invalid\_refresh\_token, or invalid\_client. error\_description identifies the specific cause. HTTP 400 and error: invalid\_grant remain unchanged.

## Facts

| Fact | Value |
| --- | --- |
| Vendor | [Conta Azul](https://harbyn.com/vendors/contaazul.md) |
| Kind | Behavior change |
| Severity | medium |
| Status | Announced |
| Announced | Sep 15, 2026 |
| Added to Harbyn | Sep 29, 2026 |
| Lead time | No dated deadline |
| Symbols | `api-v2.contaazul.com/oauth/token` |
| Review | Reviewed by a person, extracted by a model |

## Find it in your code

```sh
npx harbyn scan
```

This change names no identifier the scanner can match line by line, so the scan tells you whether your repository uses Conta Azul, from its packages and API hosts. Nothing leaves your machine.

## Sources

Where this event comes from: the page we read, when we read it, and the hash of that snapshot.

- <https://developers.contaazul.com/changelog> (changelog, fetched 2026-09-29 02:31 UTC, sha256 `0af1968cdcf6e93b44d7d487ebab614ce393be76a47b010ef32de69078663cd9`)

## Related changes

### More from Conta Azul

- [New client\_id format for new applications](https://harbyn.com/changes/contaazul/2026-10-01-novo-formato-de-client-id-para-novas-aplicacoes.md) (Behavior change, announced Oct 1, 2026)
- [refresh\_token validity extended to up to 2 years](https://harbyn.com/changes/contaazul/2026-10-01-validade-do-refresh-token-de-ate-2-anos.md) (Behavior change, announced Oct 1, 2026)
- [Financial account creation is synchronous](https://harbyn.com/changes/contaazul/2026-10-19-financial-account-creation-is-synchronous.md) (Breaking change, announced Oct 19, 2026)
- [POST account search endpoints removed](https://harbyn.com/changes/contaazul/2026-10-19-post-account-search-endpoints-removed.md) (Retirement, announced Oct 19, 2026)

### Changes at other vendors

- [VTEX: Master Data public-field restrictions](https://harbyn.com/changes/vtex/2026-10-23-master-data-public-field-restrictions.md) (effective Oct 26, 2026)
- [SEFAZ e-invoicing (NF-e, CT-e, MDF-e): NF-e/NFC-e net product value fields and prepaid ICMS group on November 3, 2026](https://harbyn.com/changes/sefaz/2026-10-01-layout-and-validation-rules-update.md) (effective Nov 3, 2026)
- [NFS-e Nacional: vAjusteBC group added in restricted production](https://harbyn.com/changes/nfse-nacional/2026-10-20-criacao-do-grupo-vajustebc.md) (announced Oct 20, 2026)
- [Asaas: Alteração na estrutura de URLs públicas do Asaas](https://harbyn.com/changes/asaas/2026-09-25-alteracao-na-estrutura-de-urls-publicas-do-asaas.md) (effective Sep 28, 2026)

[All upcoming deadlines](https://harbyn.com/deadlines.md)