Token de API
Como gerar, usar e atualizar o token da API do Controlle.
Equipe Controlle ·
O token de API permite que outros sistemas leiam e gravem dados na sua empresa no Controlle. É usado por desenvolvedores para criar integrações próprias.
Vídeo
Onde fica
Em Configurações, clique em API.

Gerar o token
- Clique em Gerar Token.
- Copie o token e guarde em local seguro.
Depois de gerado, o botão passa a ser Atualizar Token.
Usar o token
- Clique em Acessar documentação para ver os endpoints disponíveis.
- Envie o token no cabeçalho de todas as requisições:
Authorization: Bearer SEU_TOKEN.
Atualizar o token
Atualizar Token gera um novo e invalida o anterior. Todas as integrações que usavam o token antigo param de funcionar até serem atualizadas. Use quando houver suspeita de que o token vazou.
Segurança
- O token dá acesso aos dados financeiros da empresa. Não envie por e-mail ou mensagem e não publique em código aberto.
- Cada empresa tem o seu token.
Dúvidas técnicas
O link Entre em contato, na mesma tela, leva ao canal de dúvidas sobre integração.
Não sou desenvolvedor
Para consultar os dados sem programar, veja Conectar o Controlle ao ChatGPT e ao Claude.