WhatsApp Cloud API · error code

WhatsApp error 2593108: Synchronization request outside the 24-hour window

Permanent - do not retryOnboarding, migration & partner setup

Last verified against Meta for Developers - Cloud API error codes

What WhatsApp returns
Synchronization request can only be made within 24 hours of onboarding

What error 2593108 means

Code 2593108 means you called the smb_app_data synchronization endpoint too late. When a business that uses the WhatsApp Business app onboards to Cloud API through Embedded Signup with coexistence, the partner has 24 hours from onboarding to request the contacts and messaging history imports. After that, the request is refused.

Meta's onboarding guide is explicit about the stakes: miss the window and the business must be offboarded and complete the flow again. For that reason it recommends starting synchronization as soon as onboarding finishes rather than batching it into a later job. Synchronization itself can take several minutes, depending on the size of the history and how quickly you process webhooks.

The window is separate from the 24-hour customer service window that governs free-form replies (131047). The two only share a duration.

What it looks like

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

(sent more than 24 hours after onboarding, this returns 2593108)

Why it happens

  • Synchronization scheduled in a nightly batch instead of immediately after onboarding.
  • An onboarding pipeline that stalled on token exchange or webhook subscription and resumed the next day.
  • Waiting for the customer to confirm something in your app before starting the sync.
  • Manual onboarding where an operator forgot the sync step.

How to fix WhatsApp error 2593108

  1. 1Check the onboarding timestamp for this phone number; if more than 24 hours have passed, the sync cannot be done for this onboarding.
  2. 2Offboard the business customer.
  3. 3Have them complete Embedded Signup again with the WhatsApp Business app option.
  4. 4Call smb_app_data for contacts and then history straight after the new onboarding completes.

How to stop it recurring

Trigger both sync calls from the onboarding completion handler itself, not from a scheduler, and alert if either has not been made within an hour of onboarding. Tell the business up front that the import runs immediately, so nobody delays it waiting for a manual go-ahead.

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

Related codes

Error 2593108 - quick answers

What does WhatsApp error 2593108 mean?

Code 2593108 means you called the smb_app_data synchronization endpoint too late. When a business that uses the WhatsApp Business app onboards to Cloud API through Embedded Signup with coexistence, the partner has 24 hours from onboarding to request the contacts and messaging history imports. After that, the request is refused.

How do I fix WhatsApp error 2593108?

1. Check the onboarding timestamp for this phone number; if more than 24 hours have passed, the sync cannot be done for this onboarding. 2. Offboard the business customer. 3. Have them complete Embedded Signup again with the WhatsApp Business app option. 4. Call smb_app_data for contacts and then history straight after the new onboarding completes.

Should I retry after error 2593108?

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.