Skip to main content
DELETE
Delete Webhook
Destructive
Recommended. This endpoint is part of the public /v1 API reference and is the supported path for new integrations. See the migration guide for versioning guidance.
Soft-deletes a webhook subscription so new events stop being delivered to the registered URL. This action is destructive from the public API’s perspective, and the secret is not recoverable. If you create another subscription later, store its secret and update your verification configuration.

When to use this

Webhook deletion is destructive. Reach for it only when you want to permanently retire a subscription, for example:
  • A consumer service is being decommissioned.
  • The URL was registered against a development environment that no longer exists.
  • A previous integration leaked the signing secret and the cleanest mitigation is to delete the subscription, rotate any external dependencies on it, and re-register with a new secret.
If you only want to stop receiving events temporarily, use Update Webhook and set is_active to false. Disabled webhooks keep their secret and event subscriptions, so you can re-enable delivery later without coordinating a redeploy.

Verify deletion

List webhooks and confirm the deleted ID is no longer returned. If the delete request times out, check the list before repeating it. The public contract does not currently guarantee how already queued delivery attempts are handled, so keep the receiver safe to run during the transition.

Path parameters

Errors

  • 404 Not Found is returned when the webhook does not exist or has already been deleted.
  • 403 Forbidden is returned when the caller’s API key does not have webhook management permission.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Webhook ID

Example:

"webhook_abc123"

Response

Webhook deleted successfully.

message
string
Example:

"Webhook deleted successfully"

id
string
Example:

"webhook_abc123"