Skip to main content
Cada escopo é uma porta na sua chave: abra só as que a integração precisa, domínio, envio, leitura ou cancelamento.
Cada escopo libera um tipo de operação no E-mail. Use só o que sua integração precisa.

​
Como enviar a chave

Recomendado
Alternativo
A API Key pertence a um workspace. Você não acessa outro workspace com a mesma chave.

​
Combinações comuns

Só enviar

email:send

Enviar e consultar

email:send, email:read

Com agendamento

email:send, email:cancel

Setup completo

email:domains:create, email:domains:list, email:send, email:read
Lista de escopos vazia na criação = acesso ADMIN. Em produção, restrinja sempre.

​
Escopos disponíveis

Enviar e-mail imediato ou agendado. O domínio do from deve estar VERIFIED.
  • Listar enviados do workspace
  • Consultar um envio pelo id
Com domainIds na chave, a listagem fica limitada a esses domínios.
Cancelar e-mail agendado. Só com status SCHEDULED. Créditos são devolvidos.
Listar domínios, ver detalhe e verificar status no DNS.
Registrar novo domínio para verificação DNS.

​
Limite por domínio

Se a chave tiver domainIds configurados, ela só envia com remetentes (from) desses domínios. Domínio fora da lista retorna 403 (DOMAIN_NOT_ALLOWED). Lista vazia = qualquer domínio VERIFIED do workspace.

​
Erros comuns

Confira Authorization: Bearer sk_... e se a chave não foi apagada no painel.
Verifique escopo da rota, domainIds na chave e créditos (PLAN_LIMIT_CREDITS).
Verifique o domínio do from no painel antes de enviar.

​
Próximos passos