{
  "generated_from": "hookdeck/webhook-registry",
  "registry_commit": "a24c8d9784c9e9fe937c63f76adbce108201378f",
  "registry_committed_at": "2026-11-19T08:56:09Z",
  "disclaimer": "Independent reference. Not affiliated with WhatsApp.",
  "vendor": "whatsapp",
  "name": "WhatsApp",
  "official_docs": "https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks",
  "docs_checked": "2026-10-28",
  "url": "https://hookdeck.com/webhooks/whatsapp",
  "pages": [
    {
      "tab": "overview",
      "label": "Overview",
      "url": "https://hookdeck.com/webhooks/whatsapp"
    },
    {
      "tab": "events",
      "label": "Webhook events",
      "url": "https://hookdeck.com/webhooks/whatsapp/events"
    },
    {
      "tab": "mcp-events",
      "label": "MCP events",
      "url": "https://hookdeck.com/webhooks/whatsapp/mcp-events"
    },
    {
      "tab": "verify",
      "label": "Verify signatures",
      "url": "https://hookdeck.com/webhooks/whatsapp/verify"
    },
    {
      "tab": "guide",
      "label": "Production guide",
      "url": "https://hookdeck.com/webhooks/whatsapp/guide-duplicates-ordering-retries-timeouts"
    },
    {
      "tab": "skill",
      "label": "Agent skill",
      "url": "https://hookdeck.com/webhooks/whatsapp/skill"
    }
  ],
  "summary": "WhatsApp signs every webhook with X-Hub-Signature-256 (HMAC-SHA256).",
  "facts": [
    {
      "key": "signature_header",
      "label": "Signature header",
      "value": "X-Hub-Signature-256",
      "detail": "Format: sha256=<hex>",
      "source": {
        "kind": "vendor-docs",
        "label": "WhatsApp docs",
        "href": "https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/create-webhook-endpoint"
      },
      "doc_discrepancy": null
    },
    {
      "key": "scheme",
      "label": "Scheme",
      "value": "HMAC-SHA256",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "WhatsApp docs",
        "href": "https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/create-webhook-endpoint"
      },
      "doc_discrepancy": null
    },
    {
      "key": "signed_material",
      "label": "Signed material",
      "value": "{raw body}",
      "detail": "The POST body exactly as sent, with no timestamp or other data added.",
      "source": {
        "kind": "vendor-docs",
        "label": "WhatsApp docs",
        "href": "https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/create-webhook-endpoint"
      },
      "doc_discrepancy": null
    },
    {
      "key": "identified_by",
      "label": "How events are identified",
      "value": "entry[].changes[].field field in the body",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "WhatsApp docs",
        "href": "https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/overview"
      },
      "doc_discrepancy": null
    },
    {
      "key": "body_format",
      "label": "Body format",
      "value": "JSON",
      "detail": "Content type: application/json.",
      "source": {
        "kind": "vendor-docs",
        "label": "WhatsApp docs",
        "href": "https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/create-webhook-endpoint"
      },
      "doc_discrepancy": null
    },
    {
      "key": "handshake",
      "label": "URL handshake",
      "value": "GET: echo the challenge",
      "detail": "HTTP 200 with the hub.challenge value, after comparing hub.verify_token with the string stored on your server. Anything else leaves the endpoint unverified and no webhooks are sent.",
      "source": {
        "kind": "vendor-docs",
        "label": "WhatsApp docs",
        "href": "https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/create-webhook-endpoint"
      },
      "doc_discrepancy": null
    },
    {
      "key": "envelope",
      "label": "Envelope",
      "value": "object, entry",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "WhatsApp docs",
        "href": "https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks"
      },
      "doc_discrepancy": null
    },
    {
      "key": "agent_skill",
      "label": "Agent skill",
      "value": "npx skills add hookdeck/webhook-skills --skill whatsapp-webhooks",
      "detail": null,
      "source": {
        "kind": "webhook-skills",
        "label": "Agent skill →",
        "href": "https://hookdeck.com/webhooks/whatsapp/skill"
      },
      "doc_discrepancy": null
    }
  ],
  "not_yet_known": [],
  "enumeration": {
    "status": "partial",
    "source_url": "https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/overview",
    "checked": "2026-07-29"
  },
  "counts": {
    "events": 29,
    "with_payload": 24,
    "captured": 0,
    "with_description": 24,
    "resources": 7,
    "confidence": {
      "verified": 0,
      "documented": 29,
      "inferred": 0
    }
  },
  "mcp": {
    "native": "unknown",
    "checked": null,
    "via_hookdeck": "any WhatsApp event"
  },
  "events": [
    {
      "name": "account_alerts",
      "resource": "account",
      "description": "Alert on messaging limits, profile photo or Official Business Account status",
      "confidence": "documented",
      "schema_source": "from WhatsApp docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#account_alerts",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/account-alerts.json"
    },
    {
      "name": "account_review_update",
      "resource": "account",
      "description": "WhatsApp account review against policy finishes or is deferred",
      "confidence": "documented",
      "schema_source": "from WhatsApp docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#account_review_update",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/account-review-update.json"
    },
    {
      "name": "account_settings_update",
      "resource": "account",
      "description": null,
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#account_settings_update",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/account-settings-update.json"
    },
    {
      "name": "account_update",
      "resource": "account",
      "description": "Verification, sharing, policy or deletion change on a Messaging account",
      "confidence": "documented",
      "schema_source": "from WhatsApp docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#account_update",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/account-update.json"
    },
    {
      "name": "automatic_events",
      "resource": "messaging",
      "description": "Purchase or lead detected in a Click to WhatsApp ad chat",
      "confidence": "documented",
      "schema_source": "from WhatsApp docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#automatic_events",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/automatic-events.json"
    },
    {
      "name": "business_capability_update",
      "resource": "account",
      "description": "Messaging or phone number limits change, or a Messaging account is created",
      "confidence": "documented",
      "schema_source": "from WhatsApp docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#business_capability_update",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/business-capability-update.json"
    },
    {
      "name": "calls",
      "resource": "messaging",
      "description": "Call connects, changes status or ends",
      "confidence": "documented",
      "schema_source": "from WhatsApp docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#calls",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/calls.json"
    },
    {
      "name": "consumer_profile",
      "resource": "messaging",
      "description": null,
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#consumer_profile",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/consumer-profile.json"
    },
    {
      "name": "group_lifecycle_update",
      "resource": "group",
      "description": "Group is created or deleted",
      "confidence": "documented",
      "schema_source": "from WhatsApp docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#group_lifecycle_update",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/group-lifecycle-update.json"
    },
    {
      "name": "group_participants_update",
      "resource": "group",
      "description": "Group participants join, leave, are removed or request to join",
      "confidence": "documented",
      "schema_source": "from WhatsApp docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#group_participants_update",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/group-participants-update.json"
    },
    {
      "name": "group_settings_update",
      "resource": "group",
      "description": "Group settings are updated",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#group_settings_update",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/group-settings-update.json"
    },
    {
      "name": "group_status_update",
      "resource": "group",
      "description": "Group is suspended or its suspension clears",
      "confidence": "documented",
      "schema_source": "from WhatsApp docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#group_status_update",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/group-status-update.json"
    },
    {
      "name": "history",
      "resource": "business_app",
      "description": "Partner syncs a WhatsApp Business app customer's chat history",
      "confidence": "documented",
      "schema_source": "from WhatsApp docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#history",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/history.json"
    },
    {
      "name": "message_echoes",
      "resource": "messaging",
      "description": null,
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#message_echoes",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/message-echoes.json"
    },
    {
      "name": "message_template_components_update",
      "resource": "template",
      "description": "Template's components are edited",
      "confidence": "documented",
      "schema_source": "from WhatsApp docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#message_template_components_update",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/message-template-components-update.json"
    },
    {
      "name": "message_template_quality_update",
      "resource": "template",
      "description": "Template's quality score changes",
      "confidence": "documented",
      "schema_source": "from WhatsApp docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#message_template_quality_update",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/message-template-quality-update.json"
    },
    {
      "name": "message_template_status_update",
      "resource": "template",
      "description": "Template is approved, rejected, disabled, archived or unarchived",
      "confidence": "documented",
      "schema_source": "from WhatsApp docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#message_template_status_update",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/message-template-status-update.json"
    },
    {
      "name": "messages",
      "resource": "messaging",
      "description": "User sends a message, or a message you sent changes status",
      "confidence": "documented",
      "schema_source": "from WhatsApp docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#messages",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/messages.json"
    },
    {
      "name": "messaging_handovers",
      "resource": "messaging",
      "description": null,
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#messaging_handovers",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/messaging-handovers.json"
    },
    {
      "name": "partner_solutions",
      "resource": "partner_solutions",
      "description": "Multi-Partner Solution changes status",
      "confidence": "documented",
      "schema_source": "from WhatsApp docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#partner_solutions",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/partner-solutions.json"
    },
    {
      "name": "payment_configuration_update",
      "resource": "payment_configuration_update",
      "description": "Payment configuration connects, disconnects or becomes active",
      "confidence": "documented",
      "schema_source": "from WhatsApp docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#payment_configuration_update",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/payment-configuration-update.json"
    },
    {
      "name": "phone_number_name_update",
      "resource": "phone_number",
      "description": "Display name review finishes for a business phone number",
      "confidence": "documented",
      "schema_source": "from WhatsApp docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#phone_number_name_update",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/phone-number-name-update.json"
    },
    {
      "name": "phone_number_quality_update",
      "resource": "phone_number",
      "description": "Business phone number's throughput level changes",
      "confidence": "documented",
      "schema_source": "from WhatsApp docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#phone_number_quality_update",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/phone-number-quality-update.json"
    },
    {
      "name": "security",
      "resource": "phone_number",
      "description": "Business phone number's PIN or two-step verification changes",
      "confidence": "documented",
      "schema_source": "from WhatsApp docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#security",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/security.json"
    },
    {
      "name": "smb_app_state_sync",
      "resource": "business_app",
      "description": "Onboarded WhatsApp Business app contacts sync or change",
      "confidence": "documented",
      "schema_source": "from WhatsApp docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#smb_app_state_sync",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/smb-app-state-sync.json"
    },
    {
      "name": "smb_message_echoes",
      "resource": "business_app",
      "description": "Onboarded business sends, edits or deletes a message in the app",
      "confidence": "documented",
      "schema_source": "from WhatsApp docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#smb_message_echoes",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/smb-message-echoes.json"
    },
    {
      "name": "standby",
      "resource": "messaging",
      "description": null,
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#standby",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/standby.json"
    },
    {
      "name": "template_category_update",
      "resource": "template",
      "description": "Template's category changes, or is about to change",
      "confidence": "documented",
      "schema_source": "from WhatsApp docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#template_category_update",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/template-category-update.json"
    },
    {
      "name": "user_preferences",
      "resource": "messaging",
      "description": "User stops or resumes marketing messages",
      "confidence": "documented",
      "schema_source": "from WhatsApp docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/whatsapp/events#user_preferences",
      "json": "https://hookdeck.com/webhooks/whatsapp/events/user-preferences.json"
    }
  ]
}