Webhooks › Delete a webhook endpoint
Delete a webhook endpoint Unsubscribes the endpoint: no further events are delivered to it, including retries still pending. This is the "unsubscribe" half of a REST-hook trigger; call it when the automation is turned off. Endpoints are scoped to the credential's environment (live/sandbox), so a sandbox key cannot delete a live endpoint.
Arguments id string path required
Webhook endpoint ID (UUID)
DELETE /v1/webhooks/{id}
cURL Node Python Go Ruby PHP Java .NET
⧉ Copy curl -X DELETE "https://api.crisphive.com/v1/webhooks/9b2f6c3e-1a4d-4f0a-8f2e-7c5d1b3a9e01" \
-H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT" id
Responses 200 OK ▾
401 UNAUTHORIZED | API_KEY_INVALID ▾
403 API_KEY_SCOPE_INSUFFICIENT — the key authenticated but is restricted and does not carry the permission this endpoint requires. data.required_scope names the missing permission code. Mint a key that carries it (a full-access key carries all of them); this is NOT the same as your user account lacking a permission.
PLAN_MODULE_NOT_INCLUDED — the business's subscription plan does not include the module this endpoint belongs to. data.module names it. This is a BILLING answer, not a credential one: no key, however broad, can reach a module the plan excludes — the business has to upgrade. Distinguish it from API_KEY_SCOPE_INSUFFICIENT by error_code, never by status. ▾
404 WEBHOOK_NOT_FOUND ▾
429 TOO_MANY_REQUESTS — per-key rate limit exceeded (240 requests/min, shared across /v1 and /mcp). Back off for the number of seconds in the Retry-After header; every response also carries X-RateLimit-Limit / X-RateLimit-Remaining / X-RateLimit-Reset. ▾
