Codique

DevelopersErrors and limits

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.

StatusMeaningWhat to do
400The request is invalid, or a template value is missingFix the request. details or the message says what is wrong.
401Missing, wrong, revoked or deactivated credentialsCheck the key or app credentials.
402The workspace has no active subscriptionAsk your workspace admin to check Billing.
403FEATURE_NOT_IN_PLAN, or the key lacks a scopeUpgrade the plan, or create a key with the scope.
404Not found in this workspaceCheck the ID. Keys only see their own workspace.
409Conflict, for example the conversation already has a running workflowWait, or end the other run first.
429Rate limit reachedWait and retry. See the RateLimit-* headers.
502WhatsApp refused the messageRead the error; see the WhatsApp codes below.
500, 503Temporary problemRetry with a growing delay.

Rate limits

  • REST API: 60 requests per minute per API key. Every response carries RateLimit-Limit, RateLimit-Remaining and RateLimit-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.

CodeMeaningFix
131008A required parameter is missingUsually a button value: add button_variables or coupon_code.
132000Wrong number of template valuesSend exactly as many values as the template has variables.
132001Template doesn’t exist in that languageCheck template_name and language_code; sync templates.
132012A value has the wrong formatFor example, a media header given text, or an invalid link.
131047More than 24 hours since the customer last wroteSend a template instead of free-form text.
131026Message undeliverableThe number may not be on WhatsApp, or the app is too old.
131049Meta held back a marketing messageDon’t retry straight away; send less often to that person.
131042Payment issue on the WhatsApp accountThe workspace admin adds a payment method in WhatsApp Manager.
130429 / 131056Sending too fastSlow 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.