---
title: "Subscribe to WABA Webhooks"
method: POST
path: "/{Version}/{WABA-ID}/subscribed_apps"
tags: ["Webhook Subscriptions"]
---

# Subscribe to WABA Webhooks

`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

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.

## Path parameters

- `Version` string, required
- `WABA-ID` string, required

## Headers

- `User-Agent` string
- `Authorization` string, required

## Request body

- SubscriptionRequest: Request body for subscribing to WABA webhooks
  - `override_callback_uri` string: Custom webhook callback URL to override app default
  - `verify_token` string: Verification token for webhook security

## Response `200`

Successfully subscribed to WABA webhooks

- SubscriptionResponse: Response after successful subscription operation
  - `success` boolean, required: Indicates whether the subscription operation was successful
  - `data` SubscribedApp[]: Array containing subscription details
    - `id` string: Application ID
    - `name` string: Application name

## Other responses

- `400`: Bad Request - Invalid parameters or malformed request
- `401`: Unauthorized - Invalid or missing access token
- `403`: Forbidden - Insufficient permissions or access denied
- `404`: Not Found - WABA ID does not exist or is not accessible
- `422`: Unprocessable Entity - Request parameters are valid but cannot be processed
- `429`: Too Many Requests - Rate limit exceeded
- `500`: Internal Server Error - Unexpected server error

---

[API](https://skmtc.dev/meta/apis/whatsapp-business-messaging.md) - [All operations](https://skmtc.dev/meta/apis/whatsapp-business-messaging/llms.txt) - [OpenAPI document](https://skmtc.dev/meta/apis/whatsapp-business-messaging/revisions/5c1973265369?raw)