WhatsApp Cloud API · error code

WhatsApp error 2494100: Account is in maintenance mode.

RetryablePhone number registration

Last verified against Meta for Developers - Cloud API error codes

What WhatsApp returns
The business phone number is in maintenance mode.

What error 2494100 means

Code 2494100 appears in Meta's phone migration error table and says the business phone number is temporarily in maintenance mode. Meta's documented remedy is short: try again in a few minutes. It signals a temporary state on Meta's side affecting that number, not a configuration mistake in your request.

Keep it apart from 131057, which says the business account as a whole is in maintenance mode during message sends, for example while a throughput upgrade is being applied. 2494100 is tied to the phone number, and Meta lists it among the phone migration errors.

Because it is transient, the right reaction is a delayed retry rather than a change to your payload, credentials, or the number's configuration. Changing several settings while the number is in maintenance only makes it harder to tell what eventually fixed it.

What it looks like

{
  "error": {
    "code": 2494100,
    "error_data": {
      "messaging_product": "whatsapp",
      "details": "The business phone number is in maintenance mode."
    }
  }
}

Why it happens

  • Calling migration or number management endpoints while Meta is performing maintenance on the number.
  • Retrying immediately after a previous operation on the same number that put it into maintenance.
  • Automated onboarding that chains several number operations without pauses.

How to fix WhatsApp error 2494100

  1. 1Pause operations on that phone number for a few minutes.
  2. 2Retry the same request unchanged, with exponential backoff if the first retry also fails.
  3. 3Check the number's status with GET /<PHONE_NUMBER_ID> before continuing the workflow.
  4. 4If the state persists well beyond a few minutes, open a support case with the fbtrace_id.

How to stop it recurring

Build number onboarding and migration as a resumable state machine with retries and backoff per step, so a short maintenance window delays the flow instead of failing it. Avoid firing several number-level operations back to back without checking status between them.

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

Related codes

Error 2494100 - quick answers

What does WhatsApp error 2494100 mean?

Code 2494100 appears in Meta's phone migration error table and says the business phone number is temporarily in maintenance mode. Meta's documented remedy is short: try again in a few minutes. It signals a temporary state on Meta's side affecting that number, not a configuration mistake in your request.

How do I fix WhatsApp error 2494100?

1. Pause operations on that phone number for a few minutes. 2. Retry the same request unchanged, with exponential backoff if the first retry also fails. 3. Check the number's status with GET /<PHONE_NUMBER_ID> before continuing the workflow. 4. If the state persists well beyond a few minutes, open a support case with the fbtrace_id.

Can I retry after error 2494100?

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.