WhatsApp Cloud API · error code

WhatsApp error 131057: Account in maintenance mode

RetryableHTTP 500Phone number registration

Last verified against Meta for Developers - Cloud API error codes

What WhatsApp returns
Business Account is in maintenance mode

What error 131057 means

Code 131057 means the WhatsApp Business Account is temporarily in maintenance mode and cannot process sends. Meta's documented example is a throughput upgrade: when a business phone number qualifies for higher throughput, the platform upgrades it, and during that upgrade the number is briefly unusable. The throughput documentation says the process can take up to a minute, after which the number returns to service at the new level and receives further upgrades without downtime.

Because the window is short, 131057 is usually a blip rather than an outage. A handful of messages fail, then everything succeeds again. If you see it persist for more than a few minutes, it is worth checking account status, but the normal response is simply to retry after a pause.

There is nothing to change in your request, token, or template, and the messages were not sent.

It surfaces synchronously, and because upgrades are triggered by crossing the documented throughput criteria, it tends to arrive at the least convenient moment - mid-campaign, when volume is highest. Treat it like 131016 in your retry policy, but with a shorter, fixed delay.

Why it happens

  • An automatic throughput upgrade in progress on the phone number.
  • Other brief platform maintenance on the WABA.
  • Sending during the exact minute of a migration or upgrade triggered by your own configuration change.

How to fix WhatsApp error 131057

  1. 1Pause sends for that number for 30 to 60 seconds and retry.
  2. 2Watch for the business_capability_update webhook with event THROUGHPUT_UPGRADE, which confirms the upgrade completed.
  3. 3Queue messages rather than failing them so the pause is invisible to the business.
  4. 4If the condition persists for several minutes, check WhatsApp Manager and the platform status page.

How to stop it recurring

Treat 131057 as retryable with a short delay in your error policy, and back sends with a durable queue so a one-minute maintenance window causes a delay rather than lost messages. Subscribe to business_capability_update so your system can log and correlate upgrades with the brief error burst.

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

Related codes

Error 131057 - quick answers

What does WhatsApp error 131057 mean?

Code 131057 means the WhatsApp Business Account is temporarily in maintenance mode and cannot process sends. Meta's documented example is a throughput upgrade: when a business phone number qualifies for higher throughput, the platform upgrades it, and during that upgrade the number is briefly unusable.

How do I fix WhatsApp error 131057?

1. Pause sends for that number for 30 to 60 seconds and retry. 2. Watch for the business_capability_update webhook with event THROUGHPUT_UPGRADE, which confirms the upgrade completed. 3. Queue messages rather than failing them so the pause is invisible to the business. 4. If the condition persists for several minutes, check WhatsApp Manager and the platform status page.

Can I retry after error 131057?

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.