Allo

Modifier un webhook

Met à jour un endpoint webhook. Seuls les champs envoyés sont modifiés ; les champs omis restent inchangés. Envoyez enabled: false pour suspendre les…

PUT/v2/api/webhooks/{webhook_id}

Met à jour un endpoint webhook. Seuls les champs envoyés sont modifiés ; les champs omis restent inchangés. Envoyez enabled: false pour suspendre les livraisons sans supprimer l'endpoint.

Autorisation

Authorizationstring · headerrequis

Api-Key ak_live_…

Paramètres de chemin

webhook_idstringrequis

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

Corps

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.

Réponses

200Webhook updated
dataobject

A webhook endpoint.

7 champs
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