Delete Webhook

DELETE

user-webhooks

{id}

Delete Webhook

curl --request DELETE \
  --url https://api.dialnexa.com/v1/user-webhooks/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.dialnexa.com/v1/user-webhooks/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dialnexa.com/v1/user-webhooks/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dialnexa.com/v1/user-webhooks/{id}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.dialnexa.com/v1/user-webhooks/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "error": false,
  "statusCode": 200,
  "message": "Success",
  "data": {
    "message": "Webhook deleted successfully",
    "id": "webhook_c9v3nz8rq4pmxa"
  },
  "timestamp": "2026-09-07T06:00:00.000Z"
}

{
  "statusCode": 401,
  "error": true,
  "success": false,
  "data": [],
  "message": "Invalid API key",
  "errors": []
}

{
  "statusCode": 404,
  "error": true,
  "success": false,
  "data": [],
  "message": "Webhook not found for the given ID and organization",
  "errors": []
}

{
  "statusCode": 500,
  "error": true,
  "success": false,
  "data": [],
  "message": "Internal server error",
  "errors": []
}

Destructive Deletes a webhook subscription so new deliveries stop being sent to the registered URL. The response returns the deleted id in data.id. 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. Deliveries are not queued or retried, so a delivery that was already being sent when you deleted the subscription can still arrive; keep the receiver safe to run during the transition.

Path parameters

Parameter	Description
`id`	The webhook ID, for example `webhook_c9v3nz8rq4pmxa`.

Errors

404 Not Found is returned when the webhook does not exist in this workspace or has already been deleted. A webhook that belongs to another workspace is reported the same way.
401 Unauthorized is returned when the API key is missing or invalid.

Update Webhook: pause delivery without deleting the subscription.
List Webhooks: confirm the webhook is gone after deletion.
Verifying the signature: how the secret signs each delivery.

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

Webhook ID with the webhook_ prefix, as returned by Create Webhook.

Example:

"webhook_c9v3nz8rq4pmxa"

Response

Webhook deleted successfully.

success

enum<boolean>

required

Available options:

true

error

enum<boolean>

required

Available options:

false

statusCode

integer

required

Example:

200

message

string

required

Example:

"Success"

data

object

required

Show child attributes

timestamp

string<date-time>

required

Delete Webhook

curl --request DELETE \
  --url https://api.dialnexa.com/v1/user-webhooks/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.dialnexa.com/v1/user-webhooks/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dialnexa.com/v1/user-webhooks/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dialnexa.com/v1/user-webhooks/{id}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.dialnexa.com/v1/user-webhooks/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "error": false,
  "statusCode": 200,
  "message": "Success",
  "data": {
    "message": "Webhook deleted successfully",
    "id": "webhook_c9v3nz8rq4pmxa"
  },
  "timestamp": "2026-09-07T06:00:00.000Z"
}

{
  "statusCode": 401,
  "error": true,
  "success": false,
  "data": [],
  "message": "Invalid API key",
  "errors": []
}

{
  "statusCode": 404,
  "error": true,
  "success": false,
  "data": [],
  "message": "Webhook not found for the given ID and organization",
  "errors": []
}

{
  "statusCode": 500,
  "error": true,
  "success": false,
  "data": [],
  "message": "Internal server error",
  "errors": []
}

Overview

Endpoints

When to use this

Verify deletion

Path parameters

Errors

Authorizations

Path Parameters

Response

​When to use this

​Verify deletion

​Path parameters

​Errors

​Related endpoints

Authorizations

Path Parameters

Response

When to use this

Verify deletion

Path parameters

Errors

Related endpoints