Webhook Subscriptions

Unsubscribe from WABA Webhooks

Unsubscribe your application from webhook events for the specified WhatsApp Business Account. This will stop your app from receiving webhook notifications for this WABA.

Use Cases:

  • Disable webhook notifications when no longer needed
  • Clean up subscriptions during app decommissioning
  • Temporarily disable webhooks for maintenance
  • Remove subscriptions for WABAs no longer managed by your app

Rate Limiting: Standard Graph API rate limits apply. Unsubscription operations are typically processed immediately.

Important: Unsubscribing will immediately stop all webhook deliveries for this WABA. Ensure your application can handle the cessation of webhook events gracefully.

delete/{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.

Response

Successfully unsubscribed from 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.