Chaves de API

A chave deixa outro sistema consultar e alterar contatos no Papeador: listar, ver a ficha, criar, mudar, registrar notas, tarefas, compras e ofertas, além de ler projetos, estágios, produtos e a equipe.

Criar

1. No Papeador, abra Integrações → Chaves de API → Nova chave (só o dono e os admins).
2. Dê um nome (para saber quem usa, ex.: “Planilha do financeiro”) e escolha as permissões:
   • contatos:ler: consultar;
   • contatos:escrever: criar e alterar.
3. Copie a chave. Ela só aparece inteira agora; depois, a tela mostra só o começo.

Usar

Mande a chave em todas as chamadas, no cabeçalho:

Authorization: Bearer pap_…

O endereço da API é https://app.papeador.com.br/api. Cada rota, com os campos e um botão para testar com a sua chave, está em app.papeador.com.br/api/docs.

curl https://app.papeador.com.br/api/contacts?search=ana \
  -H "Authorization: Bearer pap_…"

Regras

• A chave vale só nas rotas da documentação, conforme as permissões dela. As configurações da empresa (integrações, equipe, as próprias chaves) são só com login.
• A chave age em nome de quem a criou, com o papel dessa pessoa. Se ela sair da empresa ou for pausada, a chave para.
• A tela mostra o último uso de cada chave. Revogar para na hora e não tem volta.
• Nunca coloque a chave no código que roda no navegador ou no aplicativo do celular: ela fica no seu servidor.

Para IAs

Para o Claude e outras IAs, use o MCP com o login da conta, sem chave. A chave só é necessária quando a IA não aceita login.