Configurações & integrações

Como criar chaves de API para integrar sistemas

Crie chaves de API para cadastrar colaboradores na Volú a partir de outros sistemas, como o da folha.

2 min de leitura OwnerAtualizado em 19/10/2026

As chaves de API permitem que outro sistema da empresa, como o de folha ou de RH, cadastre e atualize colaboradores na Volú automaticamente. Use quando quiser manter a Volú em dia com o seu sistema, sem importar planilhas.

Quem pode fazer isso

Somente o Owner pode criar e gerir chaves de API.

Criar uma chave

  1. 1No menu lateral, abra Configurações e clique em Integrações de API.
  2. 2Clique em Criar API Key.
  3. 3Dê um Nome da Key que identifique o sistema, como "Sistema de DP".
  4. 4Escolha o Rate Limit: quantas chamadas por minuto o sistema pode fazer.
  5. 5Clique em Criar.
  6. 6Copie a chave e guarde num lugar seguro.

A chave aparece uma única vez. Se perder, revogue e crie outra.

Usar a chave

Na aba Documentação estão o endereço, os cabeçalhos, o formato da requisição e um exemplo pronto para copiar. Passe essas informações para quem vai fazer a integração. Cada chamada cadastra ou atualiza até 100 colaboradores.

O cadastro feito pela API cria a pessoa na Volú. O acesso dela segue o login da empresa: com login corporativo (SSO), ela entra pelo e-mail de trabalho.

Acompanhar o uso

Na aba Logs, veja as últimas 100 chamadas feitas com as chaves, com a data, o resultado e a duração. Na lista de chaves, Último Uso mostra quando cada chave foi usada pela última vez.

Revogar ou excluir uma chave

  • Revogar: a chave para de funcionar, mas continua na lista.
  • Excluir: no menu da chave, apaga a chave de vez.

Revogue a chave sempre que suspeitar que ela foi exposta.

Dúvidas comuns

A chamada voltou com erro 401. A chave está errada, revogada ou expirada.

A chamada voltou com erro 429. O sistema passou do limite de chamadas por minuto da chave. Espere um pouco ou crie uma chave com limite maior.

A integração envia e-mail de boas-vindas? Não. A Volú não envia e-mail de boas-vindas pela API.

Conteúdo referente à versão 1.16.0 da Volú

Esse artigo foi útil?

Acesse a Volú e tire suas dúvidas via chat.

Acessar a Volú