Escopos da API Key

A API Key é o cartão de acesso: cada escopo abre uma porta. Em produção, libere só o que sua integração precisa.

Em poucas palavras

Authorization: Bearer sk_live_xxxxx

Alternativa: x-api-key: sk_live_xxxxx.

Escopos vazios na criação = acesso ADMIN (tudo). Em produção, restrinja sempre.

sms:send

sms:send, sms:read

sms:send, sms:cancel

sms:send, sms:read, sms:cancel

sms:send

Enviar SMS imediato ou agendado (POST /v1/sms/messages).

sms:read

Listar enviados, consultar por id e SMS recebidos (MO).

sms:cancel

Cancelar agendado (SCHEDULED), créditos devolvidos.

HTTP / `code`	O que fazer
401 `UNAUTHORIZED`	Confira `Authorization: Bearer sk_...`
403 escopo ausente	Inclua o escopo da rota na chave
403 `PLAN_LIMIT_CREDITS`	Sem créditos para enviar
403 `PLAN_LIMIT_SCHEDULING`	Agendamento fora do plano

Catálogo completo: Respostas de erro (accordion SMS).