Webhook Subscriptions

Get All Subscriptions for a WABA

Retrieve a list of all applications currently subscribed to webhook events for the specified WhatsApp Business Account.

Use Cases:

  • Monitor which apps are subscribed to WABA webhook events
  • Audit subscription configurations and permissions
  • Verify subscription status before making changes
  • Retrieve subscription details for troubleshooting

Rate Limiting: Standard Graph API rate limits apply. Use appropriate retry logic with exponential backoff.

Caching: Subscription data can be cached for short periods, but may change when apps subscribe or unsubscribe. Implement appropriate cache invalidation strategies.

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

Query parameters

fieldsstring

Comma-separated list of fields to include in the response. If not specified, default fields will be returned. Available fields: id, name, link

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 retrieved list of subscribed applications

Example response

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

Changes

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