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)

Alert on messaging limits, profile photo or Official Business Account status

Identified by entry[].changes[].field field in the body Resource account

whatsapp-account-alerts.json
{
  "object": "whatsapp_business_account",
  "entry": [ … ]
}

Send example to Inspect → View as JSON

account_review_update

documented from WhatsApp docs (example)

WhatsApp account review against policy finishes or is deferred

Identified by entry[].changes[].field field in the body Resource account

whatsapp-account-review-update.json
{
  "entry": [ … ],
  "object": "whatsapp_business_account"
}

Send example to Inspect → View as JSON

account_settings_update

documented No payload yet

Listed in WhatsApp docs ↗

Identified by entry[].changes[].field field in the body Resource account

No payload yet.

Help fill this in → View as JSON

account_update

documented from WhatsApp docs (example)

Verification, sharing, policy or deletion change on a Messaging account

Identified by entry[].changes[].field field in the body Resource account

whatsapp-account-update.json
{
  "object": "whatsapp_business_account",
  "entry": [ … ]
}

Send example to Inspect → View as JSON

business_capability_update

documented from WhatsApp docs (example)

Messaging or phone number limits change, or a Messaging account is created

Identified by entry[].changes[].field field in the body Resource account

whatsapp-business-capability-update.json
{
  "entry": [ … ],
  "object": "whatsapp_business_account"
}

Send example to Inspect → View as JSON

business_app

history

documented from WhatsApp docs (example)

Partner syncs a WhatsApp Business app customer's chat history

Identified by entry[].changes[].field field in the body Resource business_app

whatsapp-history.json
{
  "object": "whatsapp_business_account",
  "entry": [ … ]
}

Send example to Inspect → View as JSON

smb_app_state_sync

documented from WhatsApp docs (example)

Onboarded WhatsApp Business app contacts sync or change

Identified by entry[].changes[].field field in the body Resource business_app

whatsapp-smb-app-state-sync.json
{
  "object": "whatsapp_business_account",
  "entry": [ … ]
}

Send example to Inspect → View as JSON

smb_message_echoes

documented from WhatsApp docs (example)

Onboarded business sends, edits or deletes a message in the app

Identified by entry[].changes[].field field in the body Resource business_app

whatsapp-smb-message-echoes.json
{
  "object": "whatsapp_business_account",
  "entry": [ … ]
}

Send example to Inspect → View as JSON

group

group_lifecycle_update

documented from WhatsApp docs (example)

Group is created or deleted

Identified by entry[].changes[].field field in the body Resource group

whatsapp-group-lifecycle-update.json
{
  "object": "whatsapp_business_account",
  "entry": [ … ]
}

Send example to Inspect → View as JSON

group_participants_update

documented from WhatsApp docs (example)

Group participants join, leave, are removed or request to join

Identified by entry[].changes[].field field in the body Resource group

whatsapp-group-participants-update.json
{
  "object": "whatsapp_business_account",
  "entry": [ … ]
}

Send example to Inspect → View as JSON

group_settings_update

documented official schema

Group settings are updated

Identified by entry[].changes[].field field in the body Resource group

whatsapp-group-settings-update.json
{
  "object": "whatsapp_business_account",
  "entry": [ … ]
}

Send example to Inspect → View as JSON

group_status_update

documented from WhatsApp docs (example)

Group is suspended or its suspension clears

Identified by entry[].changes[].field field in the body Resource group

whatsapp-group-status-update.json
{
  "object": "whatsapp_business_account",
  "entry": [ … ]
}

Send example to Inspect → View as JSON

messaging

automatic_events

documented from WhatsApp docs (example)

Purchase or lead detected in a Click to WhatsApp ad chat

Identified by entry[].changes[].field field in the body Resource messaging

whatsapp-automatic-events.json
{
  "object": "whatsapp_business_account",
  "entry": [ … ]
}

Send example to Inspect → View as JSON

calls

documented from WhatsApp docs (example)

Call connects, changes status or ends

Identified by entry[].changes[].field field in the body Resource messaging

whatsapp-calls.json
{
  "object": "whatsapp_business_account",
  "entry": [ … ]
}

Send example to Inspect → View as JSON

consumer_profile

documented No payload yet

Listed in WhatsApp docs ↗

Identified by entry[].changes[].field field in the body Resource messaging

No payload yet.

Help fill this in → View as JSON

message_echoes

documented No payload yet

Listed in WhatsApp docs ↗

Identified by entry[].changes[].field field in the body Resource messaging

No payload yet.

Help fill this in → View as JSON

messages

documented from WhatsApp docs (example)

User sends a message, or a message you sent changes status

Identified by entry[].changes[].field field in the body Resource messaging

whatsapp-messages.json
{
  "object": "whatsapp_business_account",
  "entry": [ … ]
}

Send example to Inspect → View as JSON

messaging_handovers

documented No payload yet

Listed in WhatsApp docs ↗

Identified by entry[].changes[].field field in the body Resource messaging

No payload yet.

Help fill this in → View as JSON

standby

documented No payload yet

Listed in WhatsApp docs ↗

Identified by entry[].changes[].field field in the body Resource messaging

No payload yet.

Help fill this in → View as JSON

user_preferences

documented from WhatsApp docs (example)

User stops or resumes marketing messages

Identified by entry[].changes[].field field in the body Resource messaging

whatsapp-user-preferences.json
{
  "object": "whatsapp_business_account",
  "entry": [ … ]
}

Send example to Inspect → View as JSON

phone_number

phone_number_name_update

documented from WhatsApp docs (example)

Display name review finishes for a business phone number

Identified by entry[].changes[].field field in the body Resource phone_number

whatsapp-phone-number-name-update.json
{
  "entry": [ … ],
  "object": "whatsapp_business_account"
}

Send example to Inspect → View as JSON

phone_number_quality_update

documented from WhatsApp docs (example)

Business phone number's throughput level changes

Identified by entry[].changes[].field field in the body Resource phone_number

whatsapp-phone-number-quality-update.json
{
  "entry": [ … ],
  "object": "whatsapp_business_account"
}

Send example to Inspect → View as JSON

security

documented from WhatsApp docs (example)

Business phone number's PIN or two-step verification changes

Identified by entry[].changes[].field field in the body Resource phone_number

whatsapp-security.json
{
  "entry": [ … ],
  "object": "whatsapp_business_account"
}

Send example to Inspect → View as JSON

template

message_template_components_update

documented from WhatsApp docs (example)

Template's components are edited

Identified by entry[].changes[].field field in the body Resource template

whatsapp-message-template-components-update.json
{
  "entry": [ … ],
  "object": "whatsapp_business_account"
}

Send example to Inspect → View as JSON

message_template_quality_update

documented from WhatsApp docs (example)

Template's quality score changes

Identified by entry[].changes[].field field in the body Resource template

whatsapp-message-template-quality-update.json
{
  "entry": [ … ],
  "object": "whatsapp_business_account"
}

Send example to Inspect → View as JSON

message_template_status_update

documented from WhatsApp docs (example)

Template is approved, rejected, disabled, archived or unarchived

Identified by entry[].changes[].field field in the body Resource template

whatsapp-message-template-status-update.json
{
  "entry": [ … ],
  "object": "whatsapp_business_account"
}

Send example to Inspect → View as JSON

template_category_update

documented from WhatsApp docs (example)

Template's category changes, or is about to change

Identified by entry[].changes[].field field in the body Resource template

whatsapp-template-category-update.json
{
  "entry": [ … ],
  "object": "whatsapp_business_account"
}

Send example to Inspect → View as JSON

Other WhatsApp events

partner_solutions

documented from WhatsApp docs (example)

Multi-Partner Solution changes status

Identified by entry[].changes[].field field in the body

whatsapp-partner-solutions.json
{
  "entry": [ … ],
  "object": "whatsapp_business_account"
}

Send example to Inspect → View as JSON

payment_configuration_update

documented from WhatsApp docs (example)

Payment configuration connects, disconnects or becomes active

Identified by entry[].changes[].field field in the body

whatsapp-payment-configuration-update.json
{
  "entry": [ … ],
  "object": "whatsapp_business_account"
}

Send example to Inspect → View as JSON

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.

Not affiliated with WhatsApp. Facts are compiled from public sources and linked inline.