Skip to main content
DELETE
Delete webhook (V2)

Overview

Soft-deletes a webhook. It no longer appears in list responses, and later requests for it return 404. Deliveries stop within about 30 seconds, when delivery routing next refreshes; deliveries already queued, including their retries, still go out. The webhook can belong to the token’s company or a direct, non-cancelled sub-company (see Token scoping).
Rate limit: 4 req/s · 20/min · 600/hr · 14,400/day

Endpoint

DELETE /v2/api/webhooks/{id}

Path parameters

integer
required
Webhook ID.

Response

200 OK — empty body on success.

Error responses

Authorizations

Authorization
string
header
required

JWT Bearer token obtained from POST /v2/api/authentication/token/api-key.

Lifetime: ~24 hours (86,399 seconds). Cache the token and reuse it. Re-authenticate 5 minutes before expiry.

Scoping: API key tokens are scoped by the key's company and its action set; see Token scoping.

No refresh endpoint — re-authenticate with your API key when the token expires.

Path Parameters

id
integer
required

Response

200 OK — Empty body. Webhook deleted successfully.