Skip to main content
DELETE
/
user-webhooks
/
{id}
Delete a webhook
curl --request DELETE \
  --url https://api.dialnexa.com/v1/user-webhooks/{id} \
  --header 'Authorization: Bearer <token>'
{
  "message": "Webhook deleted."
}
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

ParameterDescription
idThe webhook ID, for example whk_c9v3nz8rq4pm.

​
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.

​
Request

curl -X DELETE "https://api.dialnexa.com/v1/user-webhooks/whk_c9v3nz8rq4pm" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

{ "message": "success" }

Authorizations

​
Authorization
string
header
required

Pass your API key as a Bearer token in the Authorization header.

Path Parameters

​
id
string
required

Response

Success.

​
message
string
Example:

"Webhook deleted."