WhatsApp webhook events
29 WhatsApp event types in 6 resources, plus Other WhatsApp events. 24 have sample payloads.
Every event here can also reach agents as an MCP event through Hookdeck: MCP events →
account
account_alerts
documented from WhatsApp docs (example)
account_alerts Alert on messaging limits, profile photo or Official Business Account status
Identified by entry[].changes[].field field in the body
Resource account
{
"object": "whatsapp_business_account",
"entry": [ … ]
} account_review_update
documented from WhatsApp docs (example)
account_review_update WhatsApp account review against policy finishes or is deferred
Identified by entry[].changes[].field field in the body
Resource account
{
"entry": [ … ],
"object": "whatsapp_business_account"
} account_settings_update
documented No payload yet
account_settings_update Identified by entry[].changes[].field field in the body
Resource account
No payload yet.
account_update
documented from WhatsApp docs (example)
account_update Verification, sharing, policy or deletion change on a Messaging account
Identified by entry[].changes[].field field in the body
Resource account
{
"object": "whatsapp_business_account",
"entry": [ … ]
} business_capability_update
documented from WhatsApp docs (example)
business_capability_update Messaging or phone number limits change, or a Messaging account is created
Identified by entry[].changes[].field field in the body
Resource account
{
"entry": [ … ],
"object": "whatsapp_business_account"
} business_app
history
documented from WhatsApp docs (example)
history Partner syncs a WhatsApp Business app customer's chat history
Identified by entry[].changes[].field field in the body
Resource business_app
{
"object": "whatsapp_business_account",
"entry": [ … ]
} smb_app_state_sync
documented from WhatsApp docs (example)
smb_app_state_sync Onboarded WhatsApp Business app contacts sync or change
Identified by entry[].changes[].field field in the body
Resource business_app
{
"object": "whatsapp_business_account",
"entry": [ … ]
} smb_message_echoes
documented from WhatsApp docs (example)
smb_message_echoes Onboarded business sends, edits or deletes a message in the app
Identified by entry[].changes[].field field in the body
Resource business_app
{
"object": "whatsapp_business_account",
"entry": [ … ]
} group
group_lifecycle_update
documented from WhatsApp docs (example)
group_lifecycle_update Group is created or deleted
Identified by entry[].changes[].field field in the body
Resource group
{
"object": "whatsapp_business_account",
"entry": [ … ]
} group_participants_update
documented from WhatsApp docs (example)
group_participants_update Group participants join, leave, are removed or request to join
Identified by entry[].changes[].field field in the body
Resource group
{
"object": "whatsapp_business_account",
"entry": [ … ]
} group_settings_update
documented official schema
group_settings_update Group settings are updated
Identified by entry[].changes[].field field in the body
Resource group
{
"object": "whatsapp_business_account",
"entry": [ … ]
} group_status_update
documented from WhatsApp docs (example)
group_status_update Group is suspended or its suspension clears
Identified by entry[].changes[].field field in the body
Resource group
{
"object": "whatsapp_business_account",
"entry": [ … ]
} messaging
automatic_events
documented from WhatsApp docs (example)
automatic_events Purchase or lead detected in a Click to WhatsApp ad chat
Identified by entry[].changes[].field field in the body
Resource messaging
{
"object": "whatsapp_business_account",
"entry": [ … ]
} calls
documented from WhatsApp docs (example)
calls Call connects, changes status or ends
Identified by entry[].changes[].field field in the body
Resource messaging
{
"object": "whatsapp_business_account",
"entry": [ … ]
} consumer_profile
documented No payload yet
consumer_profile Identified by entry[].changes[].field field in the body
Resource messaging
No payload yet.
message_echoes
documented No payload yet
message_echoes Identified by entry[].changes[].field field in the body
Resource messaging
No payload yet.
messages
documented from WhatsApp docs (example)
messages User sends a message, or a message you sent changes status
Identified by entry[].changes[].field field in the body
Resource messaging
{
"object": "whatsapp_business_account",
"entry": [ … ]
} messaging_handovers
documented No payload yet
messaging_handovers Identified by entry[].changes[].field field in the body
Resource messaging
No payload yet.
standby
documented No payload yet
standby Identified by entry[].changes[].field field in the body
Resource messaging
No payload yet.
user_preferences
documented from WhatsApp docs (example)
user_preferences User stops or resumes marketing messages
Identified by entry[].changes[].field field in the body
Resource messaging
{
"object": "whatsapp_business_account",
"entry": [ … ]
} phone_number
phone_number_name_update
documented from WhatsApp docs (example)
phone_number_name_update Display name review finishes for a business phone number
Identified by entry[].changes[].field field in the body
Resource phone_number
{
"entry": [ … ],
"object": "whatsapp_business_account"
} phone_number_quality_update
documented from WhatsApp docs (example)
phone_number_quality_update Business phone number's throughput level changes
Identified by entry[].changes[].field field in the body
Resource phone_number
{
"entry": [ … ],
"object": "whatsapp_business_account"
} security
documented from WhatsApp docs (example)
security Business phone number's PIN or two-step verification changes
Identified by entry[].changes[].field field in the body
Resource phone_number
{
"entry": [ … ],
"object": "whatsapp_business_account"
} template
message_template_components_update
documented from WhatsApp docs (example)
message_template_components_update Template's components are edited
Identified by entry[].changes[].field field in the body
Resource template
{
"entry": [ … ],
"object": "whatsapp_business_account"
} message_template_quality_update
documented from WhatsApp docs (example)
message_template_quality_update Template's quality score changes
Identified by entry[].changes[].field field in the body
Resource template
{
"entry": [ … ],
"object": "whatsapp_business_account"
} message_template_status_update
documented from WhatsApp docs (example)
message_template_status_update Template is approved, rejected, disabled, archived or unarchived
Identified by entry[].changes[].field field in the body
Resource template
{
"entry": [ … ],
"object": "whatsapp_business_account"
} template_category_update
documented from WhatsApp docs (example)
template_category_update Template's category changes, or is about to change
Identified by entry[].changes[].field field in the body
Resource template
{
"entry": [ … ],
"object": "whatsapp_business_account"
} Other WhatsApp events
partner_solutions
documented from WhatsApp docs (example)
partner_solutions Multi-Partner Solution changes status
Identified by entry[].changes[].field field in the body
{
"entry": [ … ],
"object": "whatsapp_business_account"
} payment_configuration_update
documented from WhatsApp docs (example)
payment_configuration_update Payment configuration connects, disconnects or becomes active
Identified by entry[].changes[].field field in the body
{
"entry": [ … ],
"object": "whatsapp_business_account"
} Route WhatsApp events by type.
Event Gateway receives every WhatsApp delivery and filters and routes it by event type, so each service gets only the events it handles.