Novo Portal de Desenvolvedor
A Conta Azul lançou uma nova versão das suas APIs e estamos em constante evolução.
**Recomendamos a criação de novos APPs com esta nova versão das APIs.**

Você pode continuar acessando a documentação da versão antiga [aqui](https://devdocs.contaazul.com/).

# Credenciais

Antes de começar a consumir a API da Conta Azul, siga estes passos essenciais para configurar seu ambiente de desenvolvimento.

## 1. Crie sua conta de desenvolvedor

Primeiro, crie uma conta no [Gerenciador de Aplicações da Conta Azul](https://developers-portal.contaazul.com). Essa conta permite que você gerencie todas as suas aplicações integradas ao Conta Azul Pro.

Seja seu objetivo criar um **app público** (utilizado por diversos clientes) ou um **app privado** (exclusivamente para uso próprio), será necessário ter uma conta registrada.

## 2. Crie uma nova aplicação

Após efetuar o login no Gerenciador de Aplicações:

- Clique em **"Nova Aplicação"**.
- Preencha as informações solicitadas, como nome, descrição e o tipo de aplicação (pública ou privada).
- Finalize clicando em **"Salvar"**.


## 3. Obtenha suas credenciais

Ao concluir a criação da aplicação, serão exibidas duas informações importantes:

- **`client_id`**
- **`client_secret`**


Essas credenciais são essenciais para o processo de autenticação OAuth2 e são necessárias para gerar o **`access_token`**.

> **Dica:** Você poderá acessar essas credenciais a qualquer momento na seção **"Minhas Aplicações"** do portal.


Além dessas credenciais, você também receberá um **usuário e senha para acessar uma conta teste do Conta Azul Pro (ERP)**, permitindo validar suas integrações antes de colocá-las em produção.

## 4. Gerando os tokens de acesso

Para consumir qualquer recurso da API, você precisará de:

- **`access_token`** (utilizado nas requisições à API)
- **`refresh_token`** (utilizado para renovar seu `access_token` após sua expiração)


Esses tokens são obtidos através do fluxo OAuth2 usando seu `client_id` e `client_secret`. O processo de autenticação detalhado está disponível na seção [Autenticação da API Conta Azul](/auth).

**Próximo passo:** consulte o guia completo sobre o [fluxo OAuth2 e autenticação](/auth) para começar a realizar suas primeiras chamadas à API Conta Azul.