Como Criar uma Chave de API no Odoo (Todas as Versões)

Chaves de API permitem que ferramentas externas — como nossa extensão para Gmail — se conectem de forma segura à sua instância Odoo sem usar sua senha. O processo de criação varia ligeiramente dependendo da sua versão do Odoo. Este guia abrange todas as versões do Odoo 14 ao 19 com instruções passo a passo.

1 Antes de Começar

Antes de criar uma chave de API, certifique-se de que cumpre estes requisitos:

• Você deve estar logado na sua instância Odoo
• Você precisa de uma conta de usuário interno (não um usuário portal)
• Você deve saber qual versão do Odoo está utilizando

Para verificar sua versão do Odoo, veja a parte inferior da página de Configurações ou pergunte ao administrador do sistema.

2 Odoo 14-15

No Odoo 14 e 15, as chaves de API encontram-se na seção "Developer API Keys" nas preferências do usuário.

Navegue até: Ícone do perfil (canto superior direito) → My Profile → aba Account Security

1. Clique em "New API Key"
2. Insira um nome para sua chave (ex: "Gmail Extension")
3. Clique no botão de confirmação
4. Copie a chave gerada imediatamente — ela não poderá ser recuperada depois

Nestas versões, as chaves de API são permanentes — nunca expiram.

3 Odoo 16-17

A partir do Odoo 16, a seção de chaves de API foi renomeada e não requer mais o Developer Mode.

Navegue até: Ícone do perfil (canto superior direito) → My Profile → aba Account Security

1. Clique em "New API Key"
2. Insira um nome para sua chave (ex: "Gmail Extension")
3. Clique no botão de confirmação
4. Copie a chave gerada imediatamente — ela não poderá ser recuperada depois

As chaves de API no Odoo 16-17 são permanentes — nunca expiram.

Odoo 16

Odoo 17

4 Odoo 18

O Odoo 18 introduz a expiração de chaves. Ao criar uma chave de API, você deve escolher por quanto tempo ela será válida.

Navegue até: Ícone do perfil (canto superior direito) → My Profile → aba Account Security

1. Clique em "New API Key"
2. Insira um nome para sua chave (ex: "Gmail Extension")
3. No seletor de duração, escolha "Persistent Key"
4. Clique em "Generate key"
5. Copie a chave gerada imediatamente — ela não poderá ser recuperada depois

5 Odoo 19+

O Odoo 19 redesenhou a interface de preferências do usuário. O caminho e os nomes dos botões mudaram, mas o processo é semelhante ao Odoo 18.

Navegue até: Ícone do perfil (canto superior direito) → My Preferences → aba Security

1. Clique em "Add API Key"
2. Insira um nome para sua chave (ex: "Gmail Extension")
3. No seletor de duração, escolha "Persistent Key"
4. Clique em "Generate key"
5. Copie a chave gerada imediatamente — ela não poderá ser recuperada depois

No Odoo 19, as chaves de API existentes são exibidas como cartões (visualização kanban) em vez de uma lista.

6 Referência Rápida

7 Resolução de Problemas

Erro "Invalid API Key"

Verifique se copiou a chave inteira sem espaços extras. Se estiver usando Odoo 18+, certifique-se de que a chave não expirou — crie uma nova com "Persistent Key" selecionado.

"API Key expired"

Isto acontece no Odoo 18+ quando a chave foi criada sem selecionar "Persistent Key". Crie uma nova chave e selecione "Persistent Key" como duração.

Não consigo encontrar o botão de chave de API

No Odoo 15, você precisa ativar o Developer Mode primeiro (Settings → Developer Tools → Activate). No Odoo 19+, a seção foi movida para My Preferences → Security (não Account Security).

Erro "Connection timeout"

Verifique se a URL do Odoo está correta e acessível. Certifique-se de incluir https:// e remover qualquer barra final.