Skip to main content
POST
/
api
/
domains
/
{domain_id}
/
notification-channels
cURL
curl --request POST \
  --url https://domainwarden.app/api/domains/{domain_id}/notification-channels \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "label": "Production Alerts",
  "type": "email",
  "value": "[email protected]",
  "secondary_value": "POST",
  "whois_notifications_enabled": true,
  "ssl_notifications_enabled": true,
  "dns_notifications_enabled": false
}
'
{
  "data": {
    "id": "019a11e5-3072-707a-82b2-91bf8b940e80",
    "label": "Production Alerts",
    "type": "email",
    "type_human": "Email",
    "whois_notifications_enabled": true,
    "dns_notifications_enabled": false,
    "ssl_notifications_enabled": true,
    "is_protected": false,
    "is_disabled": false,
    "disabled_reason": null,
    "last_notification_sent_at": null,
    "last_notification_sent_at_human": null,
    "created_at": "2025-10-27 10:30:00",
    "created_at_human": "just now"
  }
}

Authorizations

​
Authorization
string
header
required

You can obtain your API Token from your Domainwarden account settings.

Path Parameters

​
domain_id
string
required

The ID of the domain.

Body

application/json
​
label
string
required

A friendly label for the notification channel. Must be between 3 and 100 characters.

Example:

"Production Alerts"

​
type
string
required

The notification channel type. Available types: email, discord, slack, ms_teams, pushover, webhook

Example:

"email"

​
value
string | null
required

The notification destination value. Format depends on type (email address, webhook URL, phone number, etc.).

Example:

"[email protected]"

​
secondary_value
string | null

optional Additional value required for certain types (e.g., HTTP method for webhooks: POST, PUT, or PATCH).

Example:

"POST"

​
whois_notifications_enabled
boolean | null

optional Enable notifications for WHOIS changes. Defaults to true.

Example:

true

​
ssl_notifications_enabled
boolean | null

optional Enable notifications for SSL certificate issues. Defaults to true.

Example:

true

​
dns_notifications_enabled
boolean | null

optional Enable notifications for DNS record changes. Defaults to true.

Example:

false

Response

​
data
object