WhatsApp Cloud API · error code

WhatsApp error 131016: Service unavailable

RetryableHTTP 500Generic & request errors

Last verified against Meta for Developers - Cloud API error codes

What WhatsApp returns
A service is temporarily unavailable.

What error 131016 means

Code 131016 is a transient failure inside the WhatsApp messaging service. A component the send depended on was unavailable at that moment, and the request was not completed. No message ID is returned, so the message was not sent, and it is safe to retry without risk of a duplicate. Think of it as the WhatsApp-layer counterpart of Graph API code 2.

You will occasionally see a small trickle of 131016 on a healthy integration. That is normal and should be absorbed by retry logic. A sustained spike across all sends, especially when the WhatsApp Business Platform status page shows an incident, is a platform event and not something to debug in your code.

The code carries no information about your payload, token, template, or recipient. None of those need changing in response to it.

131016 can appear in the synchronous response or, more rarely, in a statuses webhook when a component fails after acceptance. If a spike coincides with code 2 or 131000, treat it as one incident rather than three separate bugs; the triage order is covered in the error-code guide.

Why it happens

  • A partial outage or degraded component on the WhatsApp Business Platform.
  • Capacity pressure during a traffic peak on Meta's side.
  • An upstream dependency of the messaging service being briefly unreachable.
  • Your retry behaviour amplifying a short blip into a longer stream of failures.

How to fix WhatsApp error 131016

  1. 1Check metastatus.com/whatsapp-business-api for an ongoing incident.
  2. 2Retry with exponential backoff and jitter; cap attempts and push to a dead-letter queue after that.
  3. 3Do not change payloads or tokens in response to this code.
  4. 4If the incident is prolonged, pause campaigns so retries do not pile up behind the outage.
  5. 5Resume at normal pace once a test send succeeds.

How to stop it recurring

Design sends to be durable and idempotent so a temporary unavailability costs a delay, not data. A circuit breaker that opens on consecutive 131016 responses and probes periodically keeps your queue orderly, and alerting on the error rate rather than single occurrences stops on-call from being paged for normal background noise.

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

Related codes

Error 131016 - quick answers

What does WhatsApp error 131016 mean?

Code 131016 is a transient failure inside the WhatsApp messaging service. A component the send depended on was unavailable at that moment, and the request was not completed. No message ID is returned, so the message was not sent, and it is safe to retry without risk of a duplicate. Think of it as the WhatsApp-layer counterpart of Graph API code 2.

How do I fix WhatsApp error 131016?

1. Check metastatus.com/whatsapp-business-api for an ongoing incident. 2. Retry with exponential backoff and jitter; cap attempts and push to a dead-letter queue after that. 3. Do not change payloads or tokens in response to this code. 4. If the incident is prolonged, pause campaigns so retries do not pile up behind the outage. 5. Resume at normal pace once a test send succeeds.

Can I retry after error 131016?

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.