Skip to main content
PATCH
/
api
/
domains
/
{domain_id}
/
notification-channels
/
{domainNotificationChannel_id}
cURL
curl --request PATCH \
  --url https://domainwarden.app/api/domains/{domain_id}/notification-channels/{domainNotificationChannel_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "label": "Updated Production Alerts",
  "type": "slack",
  "value": "t",
  "secondary_value": "l",
  "whois_notifications_enabled": false,
  "ssl_notifications_enabled": true,
  "dns_notifications_enabled": true
}
'
{
  "data": {
    "id": "019a11e5-3072-707a-82b2-91bf8b940e80",
    "label": "Updated Production Alerts",
    "type": "email",
    "type_human": "Email",
    "whois_notifications_enabled": false,
    "dns_notifications_enabled": true,
    "ssl_notifications_enabled": true,
    "is_protected": false,
    "is_disabled": false,
    "disabled_reason": null,
    "last_notification_sent_at": "2025-10-24 08:30:15",
    "last_notification_sent_at_human": "3 days ago",
    "created_at": "2025-10-20 14:22:30",
    "created_at_human": "7 days ago"
  }
}

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.

​
domainNotificationChannel_id
string
required

The ID of the domainNotificationChannel.

Body

application/json
​
label
string

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

Example:

"Updated Production Alerts"

​
type
enum<string>
Available options:
email,
discord,
slack,
ms_teams,
pushover,
webhook
Example:

"slack"

​
value
string | null

Must not be greater than 255 characters.

Example:

"t"

​
secondary_value
string | null

Must not be greater than 255 characters.

Example:

"l"

​
whois_notifications_enabled
boolean | null

optional Enable notifications for WHOIS changes.

Example:

false

​
ssl_notifications_enabled
boolean | null

optional Enable notifications for SSL certificate issues.

Example:

true

​
dns_notifications_enabled
boolean | null

optional Enable notifications for DNS record changes.

Example:

true

Response

​
data
object