Troubleshooting
Something not working as expected? This section covers the issues our customers run into most often, with clear diagnosis steps and solutions for each.
Browse by category below, or scan the Quick Error Reference table to identify your problem by HTTP status or error code.
If you're unable to find a resolution here, include your request ID, timestamp, and a sanitised code snippet when contacting support — it significantly speeds up diagnosis.
Browse by Category
Account Activation & KYC
Account stuck in review, KYC form requirements, approval delays, and post-approval onboarding.
Login, Signup & OTP
OTP not delivered, country code missing, signup errors, and email verification issues.
Messages Not Delivered
WhatsApp/SMS delivery failures, API vs dashboard discrepancies, and sender routing issues.
WhatsApp Templates
Failed to save template, approval delays, permission errors, and category misclassification.
WhatsApp Setup
Business Account connection errors, number linking issues, and Meta verification problems.
Phone Numbers & Sender IDs
No numbers available, country-specific availability, and sender routing configuration.
Compliance & 10DLC
10DLC registration errors, compliance form guidance, and A2P requirements.
Quick Error Reference
Map an HTTP status or error code directly to a solution:
| Status / Code | Meaning | Go to |
|---|---|---|
AUTH_002 | Missing or invalid API key | Messages Not Delivered |
401 Unauthorized | API key not accepted | Messages Not Delivered |
403 Forbidden | Key lacks permission or KYC incomplete | Account Activation |
422 Unprocessable Entity | Request body failed validation | WhatsApp Templates |
429 Too Many Requests | Rate limit exceeded | Error Handling Guide |
500 / 503 | Sent-side error or temporary outage | Status page |
ERR_ECOSYSTEM_ENGAGEMENT | Meta anti-spam filter triggered | Messages Not Delivered |
TEMPLATE_NOT_APPROVED | Template pending or rejected | WhatsApp Templates |
INSUFFICIENT_BALANCE | Account balance too low to send | Pricing & Billing |
INVALID_PHONE_NUMBER | Number format incorrect | Phone Numbers |
CHANNEL_UNAVAILABLE | WhatsApp not detected for recipient | Messages Not Delivered |
MESSAGE_FILTERED | Carrier-side content filter triggered | Messages Not Delivered |
| Sign-up failed / Server Action error | Signup form error | Login & Signup |
| OTP not received | Phone verification code not arriving | Login & Signup |
Diagnostic Checklist
Before diving deep, run through these quick checks — they resolve the majority of reported issues:
- KYC is approved — most features are locked until your account clears compliance review
- API key is present in the
x-api-keyrequest header (notAuthorization: Bearer) - API key is active and has not been rotated or revoked in the dashboard
- Phone numbers use E.164 format — e.g.
+14155552671, not14155552671or(415) 555-2671 - WhatsApp template is approved before sending — SMS templates do not require approval
- Sender Profile ID is included in API calls if you're using a dedicated number
- Sandbox mode is off if you expect real message delivery
- Account balance is positive — messages are not queued when balance is zero
Not Finding Your Issue?
FAQ
Answers to frequently asked questions about Sent.
Error Handling Guide
Retry strategies, circuit breakers, and graceful degradation patterns.
Contact Support
Open a ticket with our developer support team.