Skip to main content
DELETE
Soft delete a user webhook
Legacy endpoint - deprecated. Unversioned endpoints are scheduled for removal on July 31, 2026. Use the /v1 version for new integrations. This endpoint remains available for existing integrations until then.
Permanently removes a webhook subscription. DialNexa immediately stops attempting deliveries to the registered URL, including any events that were queued for retry. This action cannot be undone, and webhook secrets are not recoverable after deletion. If you re-create the same URL later, you must store the new secret and redeploy your verification middleware.

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.

Behavior

  • Pending retries for this webhook are dropped from the delivery queue.
  • The webhook’s signing secret is invalidated.
  • Past delivery attempts remain visible in Webhook delivery logs for audit purposes for the standard retention window.

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.

Headers

x-organization-id
string
required

RSA encrypted organization ID (base64 format)

Example:

"BASE64_ENCRYPTED_ORG_ID_HERE"

Path Parameters

id
string
required

The ID of the webhook.

Example:

"wh_123"

Response

200 - undefined