Skip to main content

​
Overview

Domainwarden sends notifications to alert you of changes to your domains, ensuring you never miss important updates.
By default, all domains send alerts to your account’s registered email address.

​
Notification Channels

Domainwarden supports multiple notification channels. You can add as many channels as you need. Supported notification channels include:
  • Email - Available on all plans
  • Discord Webhooks - Available on all plans
  • Slack Webhooks - Available on all plans
  • MS Teams Webhooks - Available on all plans
  • Pushover - Available on all plans
  • Custom Webhooks - Available on all plans
Need a channel that isn’t listed? Let us know by submitting feedback.

​
Adding a Notification Channel

1

Navigate to the Domain

Navigate to the domain’s Notifications tab and click the “Add Notification Channel” button.
2

Provide a Label

Enter a descriptive label to identify this notification channel (e.g., “Personal Email” or “Production Webhook”).
3

Choose Channel Type

Select the notification channel type.
4

Enter Destination

Provide the destination for notifications:
  • Email: Enter the email address
  • Discord Webhook: Enter the webhook URL
  • Slack Webhook: Enter the webhook URL
  • MS Teams Webhook: Enter the webhook URL
  • Pushover: Enter your user key
  • Custom Webhook: Enter your endpoint URL and select the HTTP method (POST, PUT, or PATCH)
5

Notifications to Receive

Select or deselect notification types to receive on this channel.
6

Save

Click “Create Channel” to activate this notification channel.
You will be unable to view the value of any notification channel after creation for security reasons.
You can add multiple notification channels to ensure you receive alerts through your preferred methods.

​
Custom Webhooks

Custom webhooks allow you to integrate Domainwarden with your own systems, APIs, or automation workflows.

​
Configuration

When creating a custom webhook channel:
  • Endpoint URL: The URL where Domainwarden will send notifications
  • HTTP Method: Choose POST, PUT, or PATCH based on your API requirements
  • Notification Types: Select which events should trigger this webhook

​
Payload Structure

Domainwarden sends a JSON payload with the following structure: 
{
  "notification_type": "whois_change",
  "domain": "example.com",
  "timestamp": "2025-10-18T12:34:56Z",
  "event": "whois_update",
  "changes": [
    {
      "field": "Registrant Email",
      "old_value": "[email protected]",
      "new_value": "[email protected]"
    }
  ]
}

​
Event Types

Your webhook will receive different payload structures based on the event type: WHOIS Change Events (whois_change): 
{
  "notification_type": "whois_change",
  "domain": "example.com",
  "timestamp": "2025-10-18T12:34:56Z",
  "event": "whois_update",
  "changes": [
    {
      "field": "Registrant Name",
      "old_value": "John Doe",
      "new_value": "Jane Smith"
    }
  ]
}
DNS Change Events (dns_change): 
{
  "notification_type": "dns_change",
  "domain": "example.com",
  "timestamp": "2025-10-18T12:34:56Z",
  "event": "dns_update",
  "changed_fields": ["A", "MX"],
  "changes": [
    {
      "record_type": "A Record",
      "diff": {
        "added": ["192.0.2.1"],
        "removed": ["198.51.100.1"]
      }
    }
  ]
}
SSL Certificate Issues (invalid_ssl_certificate): 
{
  "notification_type": "invalid_ssl_certificate",
  "domain": "example.com",
  "timestamp": "2025-10-18T12:34:56Z",
  "event": "ssl_certificate_issue",
  "ssl_info": {
    "issuer": "Let's Encrypt",
    "organization": "Example Corp",
    "expires_at": "2025-11-15T23:59:59Z"
  }
}
After multiple consecutive failures, you may be notified to check your webhook endpoint. Ensure your endpoint returns a 2xx status code for successful deliveries.

​
Editing a Notification Channel

1

Navigate to the Domain

Navigate to the domain’s Notifications tab and locate the notification channel you want to change.
2

Update Details

Adjust the label:
  • Label: Change the descriptive name
3

Configure Alert Types

Enable or disable specific notification types, such as WHOIS change alerts or DNS updates.
4

Save Changes

Click save to update the notification channel.
You cannot change the notification type or the destination value after creation. To adjust these, please create a new notification channel.

​
Removing a Notification Channel

1

Navigate to the Domain

Navigate to the domain’s Notifications tab and locate the notification channel you want to remove.
2

Remove Channel

Click the button marked “Destroy”.
3

Confirm Removal

Confirm the removal when prompted.
Your primary notification channel (the first one created) is protected and cannot be removed to ensure you always receive critical alerts.

​
Copying a Notification Channel

Navigate to the domain’s Notifications tab and click the “Copy from Another Domain” button.
1

Select Source Domain

Choose the domain from which you want to copy the notification channel.
2

Choose Notification Channels

Select the notification channels you wish to copy. Protected channels (the first one created for a domain) and channels that already exist in the destination domain cannot be copied.
3

Confirm Copy

Click “Copy Channels” to complete the process.