WhatsApp error 2593107: Synchronization API call limit exceeded
Last verified against Meta for Developers - Cloud API error codes
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
- 1Check your logs for the earlier sync request and its
request_id; the first call likely succeeded. - 2Confirm whether
smb_app_state_syncorhistorywebhooks arrived for that number. - 3If the data you need did arrive, rely on webhooks from here and stop calling the endpoint.
- 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
- 2593108: Synchronization request outside the 24-hour windowSynchronization request can only be made within 24 hours of onboarding
- 2593109: History sync is turned off by the business from the WhatsApp Business AppHistory sharing is turned off by the business
- 2388012: This phone number already exists in your list of phone numbers.The phone number you are trying to migrate is already present in your WhatsApp…
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.