WhatsApp Cloud API · error code

WhatsApp error 2593107: Synchronization API call limit exceeded

Permanent - do not retryOnboarding, migration & partner setup

Last verified against Meta for Developers - Cloud API error codes

What WhatsApp returns
You have exceeded the maximum number of times to call the synchronization api for this phone number.

What error 2593107 means

Code 2593107 comes from WhatsApp Business app coexistence onboarding, where a business keeps using the WhatsApp Business app on its number while a partner connects the same number to Cloud API. After onboarding, the partner calls POST /<PHONE_NUMBER_ID>/smb_app_data to pull the business's data: once with sync_type set to smb_app_state_sync for contacts, and once with history for messaging history.

Each of those calls is allowed exactly once per onboarding. 2593107 means you already made the call and are trying again. The documented recovery is heavy: the business customer must be offboarded and then complete Embedded Signup again, which resets the allowance.

A repeat call is not needed to keep data current. Later contact additions and edits arrive as smb_app_state_sync webhooks on their own, so the one-time call is only the initial import.

What it looks like

POST https://graph.facebook.com/v23.0/<PHONE_NUMBER_ID>/smb_app_data
{
  "messaging_product": "whatsapp",
  "sync_type": "smb_app_state_sync"
}

(a second call with the same sync_type after a successful first call returns 2593107)

Why it happens

  • A retry wrapper that repeats the sync request after a slow response or timeout.
  • Re-running the onboarding job for a customer who was already synchronized.
  • Calling the contacts sync again to refresh data that webhooks already keep current.
  • Two workers both picking up the same onboarding task.

How to fix WhatsApp error 2593107

  1. 1Check your logs for the earlier sync request and its request_id; the first call likely succeeded.
  2. 2Confirm whether smb_app_state_sync or history webhooks arrived for that number.
  3. 3If the data you need did arrive, rely on webhooks from here and stop calling the endpoint.
  4. 4If the import genuinely failed and must be repeated, offboard the business and have them complete Embedded Signup again.

How to stop it recurring

Make each sync call a one-shot step guarded by a persisted flag per phone number and sync type, and never place it behind an automatic retry. Store the returned request_id so support can trace the original call. If webhook delivery is in doubt, debug it with the webhook troubleshooting guide rather than calling sync again.

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

Related codes

Error 2593107 - quick answers

What does WhatsApp error 2593107 mean?

Code 2593107 comes from WhatsApp Business app coexistence onboarding, where a business keeps using the WhatsApp Business app on its number while a partner connects the same number to Cloud API. After onboarding, the partner calls POST /<PHONE_NUMBER_ID>/smb_app_data to pull the business's data: once with sync_type set to smb_app_state_sync for contacts, and once with history for messaging history.

How do I fix WhatsApp error 2593107?

1. Check your logs for the earlier sync request and its request_id ; the first call likely succeeded. 2. Confirm whether smb_app_state_sync or history webhooks arrived for that number. 3. If the data you need did arrive, rely on webhooks from here and stop calling the endpoint. 4. If the import genuinely failed and must be repeated, offboard the business and have them complete Embedded Signup again.

Should I retry after error 2593107?

No. Retrying the same request produces the same error; the condition has to be fixed first. Treat it as a permanent failure for that message and surface it, rather than looping.

Stop debugging WhatsApp by hand

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