# Managing Webhooks | Developer Documentation

<div id="bkmrk-managing-webhooksupd">## Managing Webhooks

<div><span>Updated: Dec 12, 2025</span></div><div>WhatsApp Business Accounts (WABAs) and their assets are objects in the Facebook Social Graph. When a trigger event occurs to one of those objects, Facebook sees it and sends a notification to the webhook URL specified in your Facebook App’s dashboard.</div><div>In the context of embedded signup, you can use webhooks to get notifications of changes to your WABAs, phone numbers, message templates, and messages sent to your phone numbers.</div><div>**You must [individually subscribe to every WABA](#bkmrk-subscribe-to-webhook-1) for which you wish to receive webhooks.** After fetching the client’s WABA ID, subscribe your app to the ID in order to start receiving webhooks.</div><div>See [Webhooks](/books/meta-whatsapp/page/managing-webhooks-developer-documentation) for more information about webhooks and fields.</div><div id="bkmrk-subscribe-to-webhook"><div id="bkmrk-subscribe-to-webhook-1"><div>### Subscribe to webhooks on a business customer WABA

</div></div></div><div id="bkmrk-response"><div id="bkmrk-response-1"><div>#### Response

</div></div></div><div>Upon success:</div><div>Repeat this process for any other WABAs for which you wish you receive webhooks notifications. Note that if you subscribe your app to webhooks for multiple WABAs, all webhooks notifications will be sent to the app’s callback URL specified in the **Webhooks** product panel of the App Dashboard, unless you [override webhooks](/books/meta-whatsapp/page/webhook-overrides-developer-documentation).</div><div id="bkmrk-get-all-subscription"><div id="bkmrk-get-all-subscription-1"><div>### Get all subscriptions on a WABA

</div></div></div><div>To get a list of apps subscribed to webhooks for a WABA, send a GET request to the `subscribed_apps` endpoint on the WABA:</div><div id="bkmrk-unsubscribe-from-a-w"><div id="bkmrk-unsubscribe-from-a-w-1"><div>### Unsubscribe from a WABA

</div></div></div><div>To unsubscribe your app from webhooks for a WhatsApp Business Account, send a DELETE request to the `subscribed_apps` endpoint on the WABA.</div><div id="bkmrk-overriding-the-callb"><div id="bkmrk-overriding-the-callb-1"><div>### Overriding the callback URL

</div></div></div><div>See [Webhooks Overrides](/books/meta-whatsapp/page/webhook-overrides-developer-documentation).</div><div id="bkmrk-set-up-notifications"><div id="bkmrk-set-up-notifications-1"><div>### Set up notifications

</div></div></div><div>You can set up webhooks to send you notifications of changes to your subscribed WhatsApp Business Accounts. The types of notifications you can subscribe to are:</div><div id="bkmrk-available-subscripti"><div id="bkmrk-available-subscripti-1"><div>#### Available subscription fields

</div></div></div><div><table><thead><tr><th><span>Field name </span></th><th><span>Description </span></th></tr></thead><tbody><tr><td><div><div>[account\_alerts](/documentation/business-messaging/whatsapp/webhooks/reference/account_alerts)</div></div></td><td><div><div>The **account\_alerts** webhook notifies you of changes to a business phone number’s [messaging limit](/books/meta-whatsapp/page/messaging-limits-developer-documentation), [business profile](/books/meta-whatsapp/page/business-phone-numbers-developer-documentation), and [Official Business Account](/books/meta-whatsapp/page/managing-whatsapp-business-accounts-developer-documentation) status.</div></div></td></tr><tr><td><div><div>[account\_review\_update](/documentation/business-messaging/whatsapp/webhooks/reference/account_review_update)</div></div></td><td><div><div>The **account\_review\_update** webhook notifies you when a WhatsApp Business Account has been reviewed against our policy guidelines.</div></div></td></tr><tr><td><div><div>[account\_update](/documentation/business-messaging/whatsapp/webhooks/reference/account_update)</div></div></td><td><div><div>The **account\_update** webhook notifies of changes to a WhatsApp Business Account’s [partner-led business verification](/books/meta-whatsapp/page/partner-led-business-verification-developer-documentation) submission, its [authentication-international rate](/books/meta-whatsapp/page/authentication-international-rates-developer-documentation) eligibility, or primary business location, when it is shared with a [Solution Partner](/books/meta-whatsapp/page/solution-providers-developer-documentation), [policy or terms violations](/books/meta-whatsapp/page/whatsapp-business-platform-policy-and-spam-enforcement-developer-documentation), offboarding, reconnection, or when it is deleted.</div></div></td></tr><tr><td><div><div>[automatic\_events](/books/meta-whatsapp/page/automatic-events-webhook-reference-developer-documentation)</div></div></td><td><div><div>The **automatic\_events** webhook notifies you when we detect a purchase or lead event in a chat thread between you and a WhatsApp user who has messaged you via your Click to WhatsApp ad, if you have opted-in to [Automatic Events](/books/meta-whatsapp/page/automatic-events-api-developer-documentation) reporting.</div></div></td></tr><tr><td><div><div>[business\_capability\_update](/books/meta-whatsapp/page/business-capability-update-webhook-reference-developer-documentation)</div></div></td><td><div><div>The **business\_capability\_update** webhook notifies you of WhatsApp Business Account or business portfolio capability changes ([messaging limits](/books/meta-whatsapp/page/messaging-limits-developer-documentation), [phone number limits](/books/meta-whatsapp/page/business-phone-numbers-developer-documentation), etc.).</div></div></td></tr><tr><td><div><div>[history](/books/meta-whatsapp/page/history-webhook-reference-developer-documentation)</div></div></td><td><div><div>The **history** webhook is used to synchronize the [WhatsApp Business app chat history](/books/meta-whatsapp/page/onboarding-whatsapp-business-app-users-aka-coexistence-developer-documentation) of a business customer onboarded by a solution provider.</div></div></td></tr><tr><td><div><div>[message\_template\_components\_update](/books/meta-whatsapp/page/message-template-components-update-webhook-reference-developer-documentation)</div></div></td><td><div><div>The **message\_template\_components\_update** webhook notifies you of changes to a template’s components.</div></div></td></tr><tr><td><div><div>[message\_template\_quality\_update](/books/meta-whatsapp/page/message-template-quality-update-webhook-reference-developer-documentation)</div></div></td><td><div><div>The **message\_template\_quality\_update** webhook notifies you of changes to a template’s [quality score](/books/meta-whatsapp/page/template-quality-rating-developer-documentation).</div></div></td></tr><tr><td><div><div>[message\_template\_status\_update](/books/meta-whatsapp/page/message-template-status-update-webhook-reference-developer-documentation)</div></div></td><td><div><div>The **message\_template\_status\_update** webhook notifies you of changes to the status of an existing template.</div></div></td></tr><tr><td><div><div>[messages](/books/meta-whatsapp/page/messages-webhook-reference-developer-documentation)</div></div></td><td><div><div>The **messages** webhook describes messages sent from a WhatsApp user to a business and the status of messages sent by a business to a WhatsApp user.</div></div></td></tr><tr><td><div><div>[partner\_solutions](/books/meta-whatsapp/page/partner-solutions-webhook-reference-developer-documentation)</div></div></td><td><div><div>The **partner\_solutions webhook** describes changes to the status of a [Multi-Partner Solution](/books/meta-whatsapp/page/multi-partner-solutions-developer-documentation).</div></div></td></tr><tr><td><div><div>[payment\_configuration\_update](/documentation/business-messaging/whatsapp/webhooks/reference/payment_configuration_update)</div></div></td><td><div><div>The **payment\_configuration\_update** webhook notifies you of changes to payment configurations for [Payments API India](/books/meta-whatsapp/page/payments-api-india-developer-documentation) and [Payments API Brazil](/books/meta-whatsapp/page/payments-api-brazil-developer-documentation).</div></div></td></tr><tr><td><div><div>[phone\_number\_name\_update](/books/meta-whatsapp/page/phone-number-name-update-webhook-reference-developer-documentation)</div></div></td><td><div><div>The **phone\_number\_name\_update** webhook notifies you of business phone number [display name verification](/books/meta-whatsapp/page/display-names-developer-documentation) outcomes.</div></div></td></tr><tr><td><div><div>[phone\_number\_quality\_update](/books/meta-whatsapp/page/phone-number-quality-update-webhook-reference-developer-documentation)</div></div></td><td><div><div>The **phone\_number\_quality\_update** webhook notifies you of changes to a business phone number’s [throughput level](/books/meta-whatsapp/page/throughput-developer-documentation).</div></div></td></tr><tr><td><div><div>[security](/books/meta-whatsapp/page/security-webhook-reference-developer-documentation)</div></div></td><td><div><div>The **security** webhook notifies you of changes to a business phone number’s security settings.</div></div></td></tr><tr><td><div><div>[smb\_app\_state\_sync](/books/meta-whatsapp/page/smb-app-state-sync-webhook-reference-developer-documentation)</div></div></td><td><div><div>The **smb\_app\_state\_sync** webhook is used for synchronizing contacts of [WhatsApp Business app users who have been onboarded](/books/meta-whatsapp/page/onboarding-whatsapp-business-app-users-aka-coexistence-developer-documentation) via a solution provider.</div></div></td></tr><tr><td><div><div>[smb\_message\_echoes](/books/meta-whatsapp/page/smb-message-echoes-webhook-reference-developer-documentation)</div></div></td><td><div><div>The **smb\_message\_echoes** webhook notifies you of messages sent via the WhatsApp Business app or a [companion (“linked”) device](/books/meta-whatsapp/page/onboarding-whatsapp-business-app-users-aka-coexistence-developer-documentation) by a business customer who has been [onboarded to Cloud API](/books/meta-whatsapp/page/onboarding-whatsapp-business-app-users-aka-coexistence-developer-documentation) via a solution provider.</div></div></td></tr><tr><td><div><div>[template\_category\_update](/books/meta-whatsapp/page/template-category-update-webhook-reference-developer-documentation)</div></div></td><td><div><div>The **template\_category\_update** webhook notifies you of changes to template’s [category](/books/meta-whatsapp/page/template-categorization-developer-documentation).</div></div></td></tr><tr><td><div><div>[user\_preferences](/books/meta-whatsapp/page/user-preferences-webhook-reference-developer-documentation)</div></div></td><td><div><div>The **user\_preferences** webhook notifies you of changes to a WhatsApp user’s [marketing message preferences](/books/meta-whatsapp/page/marketing-templates-developer-documentation).</div></div></td></tr></tbody></table>

</div></div>