Skip to main content
POST
/
webhooks
/
{webhook_id}
/
enable
Enable webhook
curl --request POST \
  --url https://api.dnsradar.dev/webhooks/{webhook_id}/enable \
  --header 'X-Api-Key: <api-key>'
{
  "id": "whk_abc123...",
  "created": "2023-11-07T05:31:56Z",
  "url": "https://api.server.com/webhook/dnsradar",
  "method": "POST",
  "headers": {
    "Authorization": "Bearer abc123token",
    "X-Custom-Header": "value"
  },
  "secret": "Ultra Secure P@ssw0rd!",
  "is_active": true,
  "last_error": "Timeout connecting to endpoint",
  "last_executed": "2023-11-07T05:31:56Z"
}
Enabling a webhook will resume sending notifications to the specified URL according to its configuration.
If the webhook was previously disabled due to errors, enabling it will also clear those errors and allow notifications to be sent again.
If a webhook has been automatically disabled due to repeated failures, the next enable attempt will not reset the failure count. If an error occurs again, the failure count will continue where it stopped.
So ensure the webhook is working fine before re-enabling it to avoid longer wait.

Authorizations

​
X-Api-Key
string
header
required

API key used to authenticate yourself on DNSRadar. Obtain your API key from your DNSRadar dashboard.

Path Parameters

​
webhook_id
string
required

Response

Webhook enabled

Webhook configuration for event notifications

​
id
string

Webhook identifier with 'whk_' prefix

Example:

"whk_abc123..."

​
created
string<date-time>

Webhook creation datetime in ISO 8601 format

​
url
string<uri>

Webhook endpoint URL

Example:

"https://api.server.com/webhook/dnsradar"

​
method
enum<string>
default:POST

HTTP method to use for the webhook

Available options:
POST,
PUT,
DELETE,
PATCH
​
headers
object

Custom HTTP headers as key-value pairs

Example:
{
  "Authorization": "Bearer abc123token",
  "X-Custom-Header": "value"
}
​
secret
string | null

Secret key used for HMAC-SHA256 signing of webhook requests. The signature is sent in the X-Webhook-Signature header.

Example:

"Ultra Secure P@ssw0rd!"

​
is_active
boolean

Whether webhook is active

​
last_error
string | null

Last error message if any

Example:

"Timeout connecting to endpoint"

​
last_executed
string<date-time> | null

Datetime of last execution in ISO 8601 format