Skip to main content

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.