Skip to main content
When you no longer need Knock2 to deliver events to a particular endpoint, call DELETE /v1/webhooks/{webhook_id} to remove the subscription. Knock2 stops sending payloads to the registered URL immediately upon deletion. This action is permanent — if you need to resume delivery you must create a new subscription.

​
Endpoint

​
Required Scope

Your API key must have the webhooks:write scope (or the broader all:write scope) to call this endpoint.

​
Path Parameter

​
string
required
The unique identifier of the webhook subscription to delete. You can find this value in the response from Create Webhook or List Webhooks.

​
Parameters

​
string
Act on a direct child tenant’s webhook subscription instead of your own (multi-tenant partners only). The X-Knock-Tenant header takes precedence if both are supplied. See Reading a Child Tenant’s Data.
​
string
Same as product_slug above, as a header instead of a query param. Naming a slug that isn’t a direct child of your key returns 404, never 403.

​
Example Request

​
Response

A successful deletion returns 204 No Content with an empty response body.

​
Error Responses