Set up a Webhooks listener

Configure a webhook to receive notifications when messages arrive or their delivery status changes. Webhooks operate independently of your phone number — configuring one does not affect sending or receiving messages. For background, see Introduction to receipt messages and configuration.

Update a phone number's webhook address - UpdatePhoneWebhook

Call this operation to set or update the webhook address for a phone number. The webhook receives notifications for:

• Mobile originated (MO) messages — inbound messages sent by end users

• Status reports — delivery receipts for outbound messages

API documentation

UpdatePhoneWebhook - Update a phone number's webhook address

Example

Sample success response (JSON format):

{
  "RequestId": "90E63D28-E31D-1EB2-8939-A9486641****",
  "Code": "OK",
  "Message": "null"
}

Update an account's webhook address - UpdateAccountWebhook

Call this operation to set or update the webhook address at the account level. The webhook receives notifications for:

• WhatsApp Business Account (WABA) status changes

• Phone number status changes

• Message template status changes

API documentation

UpdateAccountWebhook - Update an account's webhook address

Example

Sample success response (JSON format):

{
  "RequestId": "744c4b5c79c9432497a075bdfca3****",
  "Code": "OK",
  "Message": "SUCCESS"
}