Skip to content

Delete a webhook​

DELETE
/v1/webhooks/{id}

Requires WEBHOOKS_MANAGE, granted by WEBHOOKS_WRITE (bundles)

Deletes a webhook so new events are no longer sent to it. Send a Content-Type: application/json header even though the request has no body. A key restricted to sub-accounts can't manage webhooks.

Parameters​

Path Parameters

id*

Webhook ID: the identifier returned when the webhook was created.

Type
string
Required
Example"0b8f5d2e-7a41-4c3b-9e6d-2f1a8c7b5e90"
Format
"uuid"

Responses​

OK

Samples​

Errors

HTTPErrorWhen
400-11INVALID_REQUESTThe webhook ID isn't a valid UUID, or the Content-Type: application/json header is missing.
404-18121WEBHOOK_SUBSCRIPTION_NOT_FOUNDNo webhook with this ID exists for your business.

Plus the errors common to all signed endpoints.