Skip to Content
Webhooks

Update webhooks

PATCH
/v1/numbers/{phone_number}/webhooks

Change only the webhook URLs you send. null disables a flow.

Authorization

HTTPBearer
headerAuthorizationBearer <token>

Path Parameters

phone_number*string

Your WhatsApp number, digits only, e.g. 393401234567.

Request Body

application/json
  1. body
inbound_webhook?|

Messages users send to the number. http(s) URL, up to 255 characters. null turns the flow off. Omitted: unchanged.

outbound_webhook?|

Each message sent from the number, and each failed send. http(s) URL, up to 255 characters. null turns the flow off. Omitted: unchanged.

status_webhook?|

Status changes of the messages you sent. http(s) URL, up to 255 characters. null turns the flow off. Omitted: unchanged.

Response Body

OK

application/json
  1. response
phone_number*string

The number.

inbound_webhook*|

Receives messages users send to the number.

outbound_webhook*|

Receives each message sent from the number, and each failed send.

status_webhook*|

Receives status changes of the messages you sent.

created_at*string

When the configuration was created, UTC.

Formatdate-time
updated_at*string

When it last changed, UTC.

Formatdate-time
Example Request
curl -X PATCH 'https://api.wapiu.ai/v1/numbers/393401234567/webhooks' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "phone_number": "393401234567",  "inbound_webhook": "https://example.com/wapiu/inbound",  "outbound_webhook": null,  "status_webhook": "https://example.com/wapiu/status",  "created_at": "2026-11-22T10:15:00Z",  "updated_at": "2026-11-22T10:15:00Z"}