Configure Webhook
Sets the webhook URL and verification token for a specific app (identified by phone_number_id). This allows your system to receive real-time updates for messages and events.
Endpoint
POST /api/v1/partner/apps/:phone_number_id/webhookPath Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
phone_number_id | string | Yes | The phone number ID associated with the app |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
webhook_configuration | object | Yes | Configuration object |
webhook_configuration.override_callback_uri | string | Yes | The HTTPS URL where webhook events will be sent |
webhook_configuration.verify_token | string | Yes | A custom token to verify webhook requests |
Response
Success 200 OK
{
"success": true,
"message": "Webhook configured successfully",
"data": {
"phone_number_id": "1234567890",
"override_callback_uri": "https://animated-kind-galleon.glitch.me/webhook",
"verify_token": "VERIFY_TOKEN",
"status": "active",
"updated_at": "2026-02-15T11:15:22Z"
}
}Errors
| Status | Error | Description |
|---|---|---|
400 | Bad Request | Invalid phone_number_id or missing fields |
Try It
POST
/api/v1/partner/apps/{phone_number_id}/webhookConfigure webhook{phone_number_id}