# Como crio uma chave de API para uma integração?

Abra Minha empresa e API pública, selecione Criar chave de API, defina nome, validade e permissões e copie a chave, que só aparece uma vez.

Abrir no Kinmu: <https://my.kinmu.app/br/dashboard/company#public-api>

## No site

1. ### Abra sua empresa

   No celular, abra primeiro o menu pelo botão de menu.

   Selecione **Minha empresa** no menu lateral. As configurações aparecem.

2. ### Abra a API pública

   Na página **Minha empresa**, em **Extensões**, abra **API pública**.

   A aba **Chaves de API** aparece.

   ![Criar chave de API disponível na lista de chaves](https://kinmu.app/help/br/k0028-02.webp)

3. ### Inicie uma chave

   Selecione **Criar chave de API**. O formulário de criação aparece.

   ![Nome vazio e produção selecionada ao criar uma chave de API](https://kinmu.app/help/br/k0028-03.webp)

4. ### Identifique a integração

   Preencha **Nome**. Se houver escolha de ambiente, selecione **Produção** ou **Sandbox**. O ambiente de teste usa uma empresa com dados sintéticos.

   ![Nome preenchido e produção selecionada ao criar uma chave de API](https://kinmu.app/help/br/k0028-04.webp)

5. ### Defina a validade

   Em **Expiração**, escolha um prazo ou **Sem expiração**. Com prazo, a chave para de funcionar automaticamente quando vencer.

   ![Opções de expiração abertas ao criar uma chave de API](https://kinmu.app/help/br/k0028-05.webp)

6. ### Escolha as permissões

   Em **Escopos**, marque somente as permissões necessárias, como **Funcionários (leitura)**. A seleção fica visível no formulário.

   ![Permissão de leitura de funcionários ativada na chave de API](https://kinmu.app/help/br/k0028-06.webp)

7. ### Crie a chave

   Selecione **Criar chave**. A chave completa aparece para você copiar.

8. ### Copie e guarde a chave

   Selecione **Copiar**, guarde a chave em um local seguro e selecione **Concluído**. Ela aparece mascarada na lista e não será exibida novamente.

## Se a opção não aparecer

- A extensão de API pública precisa estar habilitada.
- Perfis necessários: **Administrador Global**, **Gerente**.
- Se o limite de chaves ativas foi atingido, revogue uma antes de criar outra.
- Selecione pelo menos uma permissão antes de criar a chave.

## Perguntas frequentes

### Perdi a chave. Como recupero?

Não é possível vê-la novamente. Use **Rotacionar** para gerar outra com as mesmas permissões ou crie uma nova. A anterior deixa de funcionar na hora, então atualize as integrações.

### Como interrompo o acesso de uma integração?

Abra a chave e selecione **Revogar**. Ela para de funcionar imediatamente, e a ação não pode ser desfeita.

## Resultado

A chave aparece na lista com seu status. A integração a envia no cabeçalho `Authorization: Bearer`. Consulte a referência técnica em [docs.kinmu.app](https://docs.kinmu.app/).