WhatsApp error 2593109: History sync is turned off by the business from the WhatsApp Business App
Last verified against Meta for Developers - Cloud API error codes
History sharing is turned off by the businessWhat error 2593109 means
Code 2593109 is not returned by an API call. It arrives inside a history webhook after you request messaging history synchronization for a business onboarded with its WhatsApp Business app number. It means the business chose not to share its chat history with you, so instead of a series of history webhooks containing past messages you receive a single one carrying this error.
Sharing is the business's decision. During coexistence onboarding the WhatsApp Business app asks the owner whether to share chat history with the partner. If they decline, contacts synchronization is a separate step, and new messages from that point on still flow through webhooks, but no past conversations are imported. When history is shared, Meta delivers messages from within 180 days of onboarding.
Your integration did nothing wrong. Handle the event as a valid outcome rather than an error to retry.
What it looks like
{
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "15550783881",
"phone_number_id": "106540352242922"
},
"history": [
{
"errors": [
{
"code": 2593109,
"title": "History sync is turned off by the business from the WhatsApp Business App",
"message": "History sync is turned off by the business from the WhatsApp Business App",
"error_data": {
"details": "History sharing is turned off by the business"
}
}
]
}
]
}Why it happens
- The business declined chat history sharing in the WhatsApp Business app during onboarding.
- History sharing was switched off in the app before you requested the sync.
- A different person completed onboarding than the one who agreed to share history.
How to fix WhatsApp error 2593109
- 1Record the outcome for the phone number and show the business that no history was imported.
- 2Do not call the history sync again; the endpoint allows one call per onboarding (see 2593107).
- 3If the business now wants history imported, they must offboard and complete Embedded Signup again, sharing history this time, within the 24-hour sync window.
- 4Continue processing new inbound and outbound messages normally.
How to stop it recurring
Explain before onboarding what history sharing does and that the choice cannot be revisited without redoing signup. Treat 2593109 as a terminal state in your import pipeline, and design the inbox so it works without past messages, and say clearly in the UI that earlier chats stay only in the WhatsApp Business app.
Official reference: Meta for Developers - Cloud API error codes. See all WhatsApp error codes or the WhatsApp limits and quotas.
Related codes
Error 2593109 - quick answers
What does WhatsApp error 2593109 mean?
Code 2593109 is not returned by an API call. It arrives inside a history webhook after you request messaging history synchronization for a business onboarded with its WhatsApp Business app number. It means the business chose not to share its chat history with you, so instead of a series of history webhooks containing past messages you receive a single one carrying this error. Sharing is the business's decision.
How do I fix WhatsApp error 2593109?
1. Record the outcome for the phone number and show the business that no history was imported. 2. Do not call the history sync again; the endpoint allows one call per onboarding (see 2593107 ). 3. If the business now wants history imported, they must offboard and complete Embedded Signup again, sharing history this time, within the 24-hour sync window. 4. Continue processing new inbound and outbound messages normally.
Should I retry after error 2593109?
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.