WhatsApp Cloud API · error code

WhatsApp error 131000: Something went wrong

RetryableHTTP 500Generic & request errors

Last verified against Meta for Developers - Cloud API error codes

What WhatsApp returns
Message failed to send due to an unknown error.

What error 131000 means

Code 131000 is the WhatsApp messaging subsystem's own unknown error. Where code 1 is the Graph API saying it could not process the request, 131000 comes from deeper inside the WhatsApp pipeline: the request was accepted, routed to the messaging service, and then failed for a reason the service could not classify. It returns HTTP 500, and no message ID is issued, so the send did not happen.

Meta adds one specific context to the documentation: when you are setting a business public key for WhatsApp Flows encryption, 131000 can mean the signature calculation failed, the internal GraphQL call failed, or GraphQL returned an error. Outside that case, the honest reading is that it is an internal fault.

Because it is unclassified, the first job is to rule out that it is actually a pattern. A single 131000 on a busy number is noise; a stream of them against one recipient, one template, or one media asset points at something on your side the platform failed to describe.

It can appear on both channels: synchronously as an HTTP 500 response body, and occasionally inside a statuses webhook when the failure happens after acceptance. Record which channel each occurrence came from - a webhook-side 131000 means a message ID was issued before the failure, so guard resends with your own idempotency key to avoid duplicates. When a burst of 131000 coincides with elevated code 1, code 2, or 131016 rates, treat it as one platform incident rather than three bugs, and check the status page before touching code; the triage order is summarized in the error-code guide. BSPs cannot see deeper into this error than you can: a provider ticket gets forwarded to Meta with the same fbtrace_id you already hold, so open the Direct Support ticket yourself if you have dashboard access.

Why it happens

  • A transient internal failure in the WhatsApp messaging service.
  • A malformed or unexpected payload that slipped past validation and broke downstream, for example unusual Unicode in a template parameter.
  • A problem with the specific media asset referenced, such as a file the platform could not process.
  • A failure while setting the business public key for Flows (signature or GraphQL error, per Meta's note).
  • Platform degradation that has not yet escalated to code 2 or 131016.

How to fix WhatsApp error 131000

  1. 1Retry once with a short backoff; most isolated 131000 responses succeed on the second attempt.
  2. 2If it repeats for the same payload, diff it against a recently successful send of the same type and strip anything unusual.
  3. 3For media messages, re-upload the asset and send by media ID instead of link.
  4. 4For the business encryption endpoint, confirm the key is a valid 2048-bit RSA public key in PEM format and regenerate it if in doubt.
  5. 5If it persists, open a Direct Support ticket with the fbtrace_id and a minimal reproducing payload.

How to stop it recurring

Give 131000 a bounded retry with backoff and idempotency, then dead-letter it rather than retrying forever. Alert on clusters of 131000 grouped by template, recipient, and media ID so a systematic cause shows up quickly. Keep fbtrace_id values in your logs; support cannot investigate without them.

Official reference: Meta for Developers - Cloud API error codes. See all WhatsApp error codes or the WhatsApp limits and quotas.

Related codes

Error 131000 - quick answers

What does WhatsApp error 131000 mean?

Code 131000 is the WhatsApp messaging subsystem's own unknown error. Where code 1 is the Graph API saying it could not process the request, 131000 comes from deeper inside the WhatsApp pipeline: the request was accepted, routed to the messaging service, and then failed for a reason the service could not classify. It returns HTTP 500, and no message ID is issued, so the send did not happen.

How do I fix WhatsApp error 131000?

1. Retry once with a short backoff; most isolated 131000 responses succeed on the second attempt. 2. If it repeats for the same payload, diff it against a recently successful send of the same type and strip anything unusual. 3. For media messages, re-upload the asset and send by media ID instead of link. 4. For the business encryption endpoint, confirm the key is a valid 2048-bit RSA public key in PEM format and regenerate it if in doubt. 5. If it persists, open a Direct…

Can I retry after error 131000?

Yes - this is a retryable condition. Back off (start around one second and double on each attempt, with jitter) and watch for a retry-after hint from the platform before resending.

Stop debugging WhatsApp by hand

Connect the channel through Conferbot: tokens, webhooks and retries are handled, failures show as readable status.