Skip to main content
DELETE
Delete a webhook subscription
  • Credential: an account API key. A trial key returns 401 unauthorized.
  • Line-scoped keys: the list of a line-scoped key is not applied here: the key deletes any subscription of the account.
  • Idempotency-Key: not honored. A second call for the same id returns 404 not_found.
  • Events: none. No event announces the deletion.
  • Guide: Deleting a subscription. The deletion is permanent: the delivery records are deleted with the subscription, the requests not sent are dropped, and the events that only this subscription received leave the events feed. The operation returns 204 with no body.

Errors

The errors that every operation shares are in Errors.

Authorizations

Authorization
string
header
required

An API key created in the iSnap dashboard, or a trial key, sent as Authorization: Bearer <key>. An API key starts with isnap_live_ or isnap_test_; both act on the same account, lines and billing. A trial key acts on its trial only.

Path Parameters

id
string
required

Id of the webhook subscription, as returned in id by POST /v1/webhooks: wh_ followed by 25 letters or digits.

Pattern: ^wh_[0-9A-Za-z]{25}$
Example:

"wh_3Kp8Rn9Fh2Lm5Qx7Vw1Yz4Bc6"

Response

The webhook subscription is deleted. No body.