Overview
Update the webhook URL associated with a connected WhatsApp Business phone number. The webhook receives incoming message events, delivery statuses, and other WhatsApp events required for AI Agent communication.Prerequisites
- Bearer Token authentication
- A connected WhatsApp Business phone number
Request
string
required
Bearer token for authenticated workspace access.
Request Body
string
required
Unique identifier of the connected WhatsApp Business phone number.
string
required
Public HTTPS endpoint that will receive WhatsApp webhook events.
Response
boolean
Indicates whether the request completed successfully.
integer
HTTP status code returned by the API.
string
Confirmation message indicating the webhook was updated successfully.
object
Updated webhook configuration.
string
WhatsApp Business phone number whose webhook was updated.
string
Configured webhook URL.
Error Handling
The webhook URL must be publicly accessible over HTTPS so Meta can deliver WhatsApp events successfully.
Related endpoints:
POST /api/whatsapp/validate-whatsapp-number— Validate a WhatsApp Business number.POST /api/whatsapp/whatsapp-integration— Create a new WhatsApp integration.GET /api/whatsapp/whatsapp-number— View connected WhatsApp Business numbers.

