MEmeta
Webhook Subscriptions

Subscribe to WABA Webhooks

Subscribe your application to webhook events for the specified WhatsApp Business Account. This enables your app to receive real-time notifications for events such as message deliveries, status updates, and other WABA activities.

Use Cases:

  • Enable webhook notifications for your app
  • Configure custom callback URLs for webhook delivery
  • Set up webhook verification tokens for security
  • Override default app webhook settings for specific WABAs

Rate Limiting: Standard Graph API rate limits apply. Subscription operations may have additional throttling to prevent abuse.

Security: Always use HTTPS endpoints for webhook callbacks. Verify webhook authenticity using the provided verification tokens and signature validation.

post/{Version}/{WABA-ID}/subscribed_apps

Request

  • Base URL
    https://graph.facebook.com
  • URL
    https://graph.facebook.com/{Version}/{WABA-ID}/subscribed_apps
  • Auth
    HTTP bearer

Path parameters

Versionstring required

Graph API version to use for this request. Determines the API behavior and available features.

WABA-IDstring required

WhatsApp Business Account ID. This ID can be found in your WhatsApp Manager or through business management APIs.

Headers

User-Agentstring
Example:Meta-Business-Messaging-OpenAPI/1.0.0;spec=2025-10-21

The user agent string identifying the client software making the request.

Authorizationstring required
Example:Bearer EAABwzLixnjYBOzYmNMJJGfHq9DgNh...

Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.

Request body

override_callback_uristring

Custom webhook callback URL to override app default

verify_tokenstring

Verification token for webhook security

Example request

{
  "override_callback_uri": "https://your-webhook-endpoint.com/webhook",
  "verify_token": "YOUR_VERIFY_TOKEN_PLACEHOLDER"
}

Response

Successfully subscribed to WABA webhooks

successboolean required

Indicates whether the subscription operation was successful

Example response

{
  "success": true,
  "data": [
    {
      "id": "9876543210987654",
      "name": "WhatsApp Integration App"
    }
  ]
}

Changes

No recorded changes to this operation across all 5 revisions of this API.