Sign In
Sign In
  1. Home
  2. APIs
  3. WhatsApp Push v1.0
  4. Webhooks
APIs
37 articles
WhatsApp Push v1.03
Introduction
Launch your WhatsApp Push campaign3
Webhooks
Agent Handover v1.04
Data Compliance API4
Widget Javascript API4
Message Trigger v1.12
Messaging v1.14

Webhooks

Configure a webhook URL to receive JSON error notifications when a WhatsApp push message campaign fails at Meta.

Updated on September 24, 2026

You can provide a webhook URL when you setup the WhatsApp push feature on your channel. The webhook will be called if there is an error with your push message campaign.

Webhook Payload

The webhook payload is a JSON object that includes information about the push message and the error that was returned from the Meta API.

Here are the fields in the webhook payload:

  • push_message: (object, required) The push message that you attempted to send. This is the same as the template object in the request body.

  • error: (string, required) If there was an error with your request, this field contains the error message from Meta.

Example

Here is an example of a webhook payload:

JSON
[
  {
    "push_message": {
      "messaging_product": "whatsapp",
      "to": "SOME_PHONE_NUMBER",
      "type": "template",
      "template": {
        "name": "YOUR_TEMPLATE_NAME",
        "language": {
          "code": "en"
        },
        "components": [
          {
            "type": "body",
            "parameters": [
              {
                "type": "text",
                "text": "Some text"
              }
            ]
          }
        ]
      }
    },
    "error": "{\"error\":{\"message\":\"(#132001) Template name does not exist in the translation\",\"type\":\"OAuthException\",\"code\":132001,\"error_data\":{\"messaging_product\":\"whatsapp\",\"details\":\"template name (YOUR_TEMPLATE_NAME) does not exist in en\"},\"error_subcode\":2494073,\"fbtrace_id\":\"AE9jPfwk6-lgxrhmyNUuovy\"}}"
  }
]

 

Was this article helpful?

Made from France 💙

Categories

  • ANALYTICS
  • BUILD
  • LOUIS AI
  • INTEGRATE

🔗 Useful Links

  • Sign In
  • Website
  • Terms & Conditions

© 2026

MindsayPowered by Mindsay

Search the help center…

Search help center articles