Allo

Update webhook

Updates a webhook endpoint. Only the fields you provide are changed. Omitted fields are left untouched.

PUT/v2/api/webhooks/{webhook_id}

Updates a webhook endpoint. Only the fields you send are changed; omitted fields are left untouched. Send enabled: false to pause deliveries without deleting the endpoint.

Authorization

Authorizationstring · headerrequired

Api-Key ak_live_…

Path parameters

webhook_idstringrequired

The webhook endpoint ID (e.g. "ep_2NfDKEm9sF8xK3pQr1Zt").

Body

urlstring<uri>

New HTTPS delivery URL.

topicsenum<string>[]

Replacement set of event topics.

call.receivedcall.triggeredcall.answeredcall.completedtag.addedtag.removedsms.receivedsms.sentcontact.createdcontact.updatedsummary.updated

descriptionstring

New label.

enabledboolean

Enable or disable the endpoint.

Responses

200Webhook updated
dataobject

A webhook endpoint.

7 fields
idstring

Unique webhook endpoint ID.

urlstring<uri>

HTTPS URL that receives event deliveries.

topicsenum<string>[]

Event topics this endpoint is subscribed to.

call.receivedcall.triggeredcall.answeredcall.completedtag.addedtag.removedsms.receivedsms.sentcontact.createdcontact.updatedsummary.updated

descriptionstring | null

Optional human-readable label.

enabledboolean

Whether the endpoint is active.

signing_secretstring | null

Secret used to verify delivery signatures. Returned only when the webhook is created or fetched by ID.

created_atstring<date-time> | null

When the endpoint was created.

400
401
404
429