> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hubfy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# API keys

> Crie e administre as credenciais da integração no painel.

Uma chave pertence ao usuário que a criou e à conta Hubfy em que foi criada. Ela autentica a integração somente nessa conta e carrega as permissões escolhidas. Seu segredo usa o prefixo `sk_live_`. O cadastro da chave tem um ID `ak_...`, que identifica a credencial no painel e não substitui o segredo na autenticação.

## Criar uma chave

1. Entre como proprietário da conta.
2. Abra **Meu perfil → API Keys** dentro da conta desejada.
3. Informe um nome, as permissões e, se necessário, a data de expiração.
4. Copie o segredo completo quando for exibido e armazene-o no servidor da integração.

Cada usuário pode ter até **cinco chaves ativas e não expiradas por conta**. Consultas posteriores mostram somente os identificadores mascarados; não permitem recuperar o segredo.

## Editar ou revogar

O proprietário da conta vê e administra somente as próprias chaves: pode alterar nome, permissões e validade. O segredo não é editável. Revogar é permanente e interrompe a autenticação com aquela chave.

Para substituir uma credencial, crie outra chave, atualize sua integração e revogue a anterior depois de verificar a troca. Remover ou desativar o acesso do usuário à conta revoga permanentemente suas chaves nela. Um convite posterior não reativa essas credenciais. Excluir o usuário também interrompe o acesso.

## Limite da administração

Uma chave da API não cria, lista, edita ou revoga outras chaves. A administração exige a sessão autenticada do proprietário no painel. Destinos de webhook e histórico de eventos e entregas continuam pertencendo à conta e exigem sessão de proprietário.

Por exemplo, Fred cria uma chave na Rocket. Essa chave acessa apenas a Rocket, mesmo que Fred também tenha acesso a outra empresa. Outro proprietário da Rocket não vê nem altera essa chave.

Use o segredo somente nas [operações públicas](https://docs.hubfy.io/api-reference/introduction.md#recursos-disponíveis) e respeite as [permissões](https://docs.hubfy.io/api-reference/authentication.md#permissões) selecionadas.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.