​

Antes de comecar

• Crie uma API key no dashboard da Rewrite.
• Mantenha a chave apenas no backend.
• Use um numero valido em E.164, por exemplo +5511999999999.
• Se quiser comportamento deterministico de testes, use Sandbox.

​

Envie seu primeiro SMS

curl -X POST "https://api.rewritetoday.com/v1/messages" \
  -H "Authorization: Bearer rw_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: msg:quickstart:2026-05-06T18:30" \
  -d '{
    "to": "+5511999999999",
    "content": "Rewrite: seu codigo de verificacao e 123456",
    "tags": {
      "flow": "quickstart"
    }
  }'

{
  "ok": true,
  "data": {
    "id": "748395130237498500",
    "createdAt": "2026-05-06T18:30:00.000Z",
    "analysis": {
      "characters": 41,
      "encoding": "gsm7",
      "segments": {
        "concat": 153,
        "count": 1,
        "reason": "fits",
        "single": 160
      }
    },
    "sandbox": false
  }
}

​

Proximos passos comuns

• Consulte a mensagem depois com GET /messages/{id}.
• Envie lotes com POST /messages/batch.
• Adicione webhooks para receber message.sent, message.delivered, message.failed, message.received, message.batch e sms.otp.
• Use templates quando precisar ler variantes localizadas e enviar por templateId.
• Use Sandbox magic numbers para forcar resultados deterministas em testes.

​

Troubleshooting

• 400 INVALID_JSON_BODY: body, telefone ou validacao especifica da rota falhou.
• 401 INVALID_OR_MISSING_API_KEY: bearer token ausente ou invalido.
• 403 API_KEY_MODE_MISMATCH: o modo da API key nao corresponde ao modo atual do projeto.
• 403 PROJECT_SUBSCRIPTION_REQUIRED ou PROJECT_BILLING_PAYMENT_REQUIRED: projeto bloqueado para envio.
• 429 RATE_LIMITED: faca backoff e respeite os headers de retry.