Skip to navigation
REST APIWebhooks

Update a webhook subscription

View as Markdown

Authentication

AuthorizationBearer

Your Dial API key, sent as Authorization: Bearer sk_live_...

Path parameters

idstringRequired

Request

This endpoint expects an object.
targetUrlstringOptionalformat: "uri"

HTTPS only; not a private/loopback host.

eventTypeslist of enumsOptional
phoneNumberIdslist of strings or nullOptional

Replace the numbers the webhook covers. Send null to cover every number on the account again; omit it to leave the numbers unchanged. An empty list, or an id that isn’t one of your active numbers, is rejected with 400.

Response

The updated subscription. The signing secret is unchanged and returned masked.
webhookobjectOptional

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error