Developers · Guides
Errors and limits
Status codes, error codes, WhatsApp errors and rate limits.
On this page
HTTP status codes
Errors are JSON: { "error": "message" }, sometimes with a code.
| Status | Meaning | What to do |
|---|---|---|
| 400 | The request is invalid, or a template value is missing | Fix the request. details or the message says what is wrong. |
| 401 | Missing, wrong, revoked or deactivated credentials | Check the key or app credentials. |
| 402 | The workspace has no active subscription | Ask your workspace admin to check Billing. |
| 403 | FEATURE_NOT_IN_PLAN, or the key lacks a scope | Upgrade the plan, or create a key with the scope. |
| 404 | Not found in this workspace | Check the ID. Keys only see their own workspace. |
| 409 | Conflict, for example the conversation already has a running workflow | Wait, or end the other run first. |
| 429 | Rate limit reached | Wait and retry. See the RateLimit-* headers. |
| 502 | WhatsApp refused the message | Read the error; see the WhatsApp codes below. |
| 500, 503 | Temporary problem | Retry with a growing delay. |
Rate limits
- REST API: 60 requests per minute per API key. Every response carries
RateLimit-Limit,RateLimit-RemainingandRateLimit-Reset. - WhatsApp also limits how many different customers each number can start conversations with per day (the number’s tier). It grows as you send good-quality messages.
WhatsApp error codes
These come from WhatsApp itself and appear in the error text.
| Code | Meaning | Fix |
|---|---|---|
131008 | A required parameter is missing | Usually a button value: add button_variables or coupon_code. |
132000 | Wrong number of template values | Send exactly as many values as the template has variables. |
132001 | Template doesn’t exist in that language | Check template_name and language_code; sync templates. |
132012 | A value has the wrong format | For example, a media header given text, or an invalid link. |
131047 | More than 24 hours since the customer last wrote | Send a template instead of free-form text. |
131026 | Message undeliverable | The number may not be on WhatsApp, or the app is too old. |
131049 | Meta held back a marketing message | Don’t retry straight away; send less often to that person. |
131042 | Payment issue on the WhatsApp account | The workspace admin adds a payment method in WhatsApp Manager. |
130429 / 131056 | Sending too fast | Slow down and retry with a growing delay. |
Codique’s own template check catches most mistakes before WhatsApp does. You get TEMPLATE_VALUES_MISSING with the names of the missing values.
Still stuck? Contact us with what you were doing and the exact message you saw.