Skip to content

WhatsApp Cloud API

WhatsApp API error codes, and what to do about each

All 86 error codes Meta documents for the WhatsApp Cloud API, grouped by what went wrong. Each one links to a page with its causes, fixes and retry advice.

How a WhatsApp error reaches you through InfiQ

InfiQ passes Meta's error through unchanged, so the codes on this page are the codes you see. If Meta refuses a send straight away, the API response carries Meta's error object (code, message, error_data.details, fbtrace_id) together with an InfiQ_traceid. If Meta accepts the message and it fails later, InfiQ posts a message.failed webhook with the Meta code in metaErrorCode. Keep both trace IDs with the failed message: Meta's support uses the fbtrace_id, InfiQ's support the InfiQ_traceid.

Marketing Messages API

Codes Meta documents for sending marketing templates through its Marketing Messages API.

Source: Meta's WhatsApp error codes reference, checked 21 November 2026. Section headings (Sending and delivery, Rate limits and so on) are InfiQ's grouping, not Meta's.

FAQ

Frequently asked questions

Where do WhatsApp API error codes come from?

They are Meta's codes for the WhatsApp Business Platform. Each error carries a numeric code, a message such as "(#130429) Rate limit hit", a details text with the likely reason and an fbtrace_id. Build your handling around the code and the details, not the HTTP status.

Which WhatsApp errors should I retry?

Retry temporary ones with backoff: rate limits such as 130429 and 131056, and Meta service errors such as 131000 and 131016. Don't retry delivery refusals such as 131050 or 130403, and fix the request first for errors like 131008, 131009 or 132001.

Why do some WhatsApp errors arrive in a webhook instead of the API response?

Meta checks some things only at delivery time. The send is accepted and returns a message ID, and the failure comes later as a failed status. Through InfiQ that arrives as a message.failed webhook with the Meta code in metaErrorCode.

Are error subcodes still returned?

Meta has deprecated error_subcode and says it is not returned from Graph API v16.0 onwards. Use the code and the details text instead.

Meta Business Partner

Send WhatsApp messages with errors you can act on.

InfiQ's API returns Meta's codes with a trace ID and posts every delivery failure to your webhook, so nothing fails silently.

7-day free trial Enterprise-grade reliability Live in 2 hours Built for Indian businesses