APIReference
Error codes
This is a representative set. The full, versioned catalogue ships with your API key.
| Code | HTTP status | How to fix it |
|---|---|---|
| invalid_number | 400 | The recipient number isn't a valid E.164 number. Include the country code, e.g. +91XXXXXXXXXX. |
| template_mismatch | 422 | The content sent doesn't match the registered DLT template exactly. Diff against your approved template string. |
| entity_not_bound | 403 | Your header or template isn't TM-chain-bound to this entity yet. Check status in your dashboard or ask us to confirm. |
| consent_required | 403 | This is a promotional send to a number without a recorded opt-in. Log consent before sending, or use a transactional template if eligible. |
| rate_limited | 429 | You've exceeded your current rate limit. See Rate Limits, or ask us to raise your ceiling. |
| invalid_api_key | 401 | Check you're using the right key for the right environment — sandbox keys don't work against production. |
Stuck on an error?
Send us the message ID and we'll dig in.