Integrations & API
Error codes reference
3 minutes read time Difficulty: intermediate
Error codes reference
Common error codes you may encounter when using the AIsoule API or sending messages.
HTTP status codes
| Code | Meaning | Action |
|---|---|---|
| 200 | Success | Request completed |
| 400 | Bad Request | Check your request body/params |
| 401 | Unauthorized | Invalid or missing API key |
| 403 | Forbidden | Insufficient permissions |
| 404 | Not Found | Resource doesn't exist |
| 409 | Conflict | Duplicate resource |
| 429 | Rate Limited | Wait and retry |
| 500 | Server Error | Retry; contact support if persistent |
WhatsApp-specific errors
| Code | Error | Solution |
|---|---|---|
| 131047 | Re-engagement message | Outside 24h window — use a template |
| 131048 | Spam rate limit | Too many messages — slow down |
| 131049 | Message not sent | Generic failure — check number validity |
| 131051 | Unsupported message type | Message type not allowed for this number |
| 131052 | Media download failed | Media URL is inaccessible |
| 131053 | Media upload failed | File too large or wrong format |
| 131056 | Pair rate limit | Too many messages to new contacts |
| 131057 | Account in maintenance | Wait and retry in a few minutes |
| 368 | Temporarily blocked | Quality issues — review your content |
| 130429 | Rate limit hit | Slow down sending speed |
AIsoule-specific errors
| Error message | Cause | Solution |
|---|---|---|
| "Outside service window" | 24h window expired | Send a template message |
| "Template not approved" | Template pending/rejected | Wait for approval or fix and resubmit |
| "Account disconnected" | Token expired | Reconnect account or refresh token |
| "Recipient not on WhatsApp" | Number doesn't have WhatsApp | Verify the number |
| "Rate limit exceeded" | Too many API calls | Implement backoff, wait 60 seconds |
| "Invalid phone number" | Wrong format | Use country code, digits only |
Tips
- Log error codes — Helps with debugging patterns
- Implement retry for 429/500 — These are temporary
- Don't retry 400/401/403 — These need code fixes
- Check Meta status — metastatus.com for outages
Related Articles
Was this guide helpful?
Your feedback helps us make these guides better for everyone.