Notification Channels Overview
Notification channels are how you receive alerts for incidents and monitor events. Configure channels once, then link them to one or more status pages.

What Are Notification Channels?
A notification channel is a destination for your alerts. You can create multiple channels (for different teams/tools) and enable/disable them per status page.
These channels are for owner/team alerts. Public status page subscribers are configured separately and can optionally use per-component subscriber delivery filters.
They are also separate from your personal dashboard alert preferences, such as browser notifications, the notification bell, and incident alarm sounds. For those account-level settings, see Personal Notification Preferences.
Where you manage them
- Create/edit channels:
/user/status-pages/notifications - Link channels to a status page:
/user/status-pages/{status_page_id}/settings#notifications - Audit everything in one place (matrix):
/user/notifications/hub
If you want incidents to automatically route to a rotating on-call person (with escalation), see: On-Call Scheduling.
Team Channels vs. Personal Alerts
It is common to use both systems together:
- Notification channels send alerts to your shared destinations such as Slack, email, PagerDuty, webhooks, or SMS
- Personal alerts control how your own signed-in dashboard session behaves
Personal alerts include:
- browser notifications for incidents
- the in-app notification bell and full notification history
- optional critical incident alarm sounds
Configure those personal preferences here: Personal Notification Preferences.
Available Channel Types
| Icon | Channel | Description | Setup guide |
|---|---|---|---|
| Discord | Rich embed notifications land directly in your Discord channels — perfect for dev teams and communities. Paste a webhook URL and you're done. | Jump to setup | |
| Slack | Formatted block messages with thread support keep your workspace informed. Configure a bot token + channel ID and route alerts to the right channel. | Jump to setup | |
| Telegram | Instant push notifications via a Telegram bot — great for on-call engineers and small teams who live on mobile. Supports groups and channels. | Jump to setup | |
| Webhooks | POST structured JSON to any endpoint — pipe events into Zapier, Make, n8n, or your own microservices. Custom headers, a body template, and auth are all supported. | Jump to setup | |
| HTML-formatted incident emails with direct links — the reliable fallback that works on every device. Your account email is enabled by default. | Jump to setup | ||
| Microsoft Teams | Adaptive cards with status colors and action buttons surface directly in Teams conversations. Enterprise-grade security, zero extra config. | Jump to setup | |
| Pushover | Native push notifications on iOS and Android with priority levels and custom sounds. Critical alerts break through Do Not Disturb. | Jump to setup | |
| PagerDuty | Trigger and auto-resolve PagerDuty incidents via Events API v2 so your on-call flow stays aligned with monitor failures and recoveries. | Jump to setup | |
| Google Chat | Send alerts to Google Chat spaces using an incoming webhook URL. Fast to set up, great for teams already on Google Workspace. | Jump to setup | |
| Mattermost | Route incident and uptime alerts into Mattermost via incoming webhook. Ideal for self-hosted chat setups and ops teams. | Jump to setup | |
| Rocket.Chat | Deliver alerts into Rocket.Chat using an incoming webhook URL. Works well for self-managed environments and internal teams. | Jump to setup | |
| SMS | Text message alerts via your own Twilio, Vonage, MessageBird, or Esendex account — a delivery path that works with no app and no internet connection. | Jump to setup | |
| ntfy | Push alerts to the public ntfy.sh server or your own self-hosted instance. No account required — pick a topic and go. | Jump to setup | |
| Gotify | Deliver alerts to your self-hosted Gotify server. A lightweight, self-managed alternative to commercial push services. | Jump to setup | |
| Matrix | Post alerts directly into a Matrix room on your own homeserver — an open, federated alternative to hosted chat platforms. | Jump to setup | |
| Send incident alerts to WhatsApp via your own Twilio account — reach teams and on-call engineers wherever they already are. | Jump to setup | ||
| Voice Call | An automated phone call reads the alert aloud — the escalation path for when a push notification isn't enough to wake someone up. | Jump to setup | |
| Jira Service Management | Raise and auto-resolve alerts in Jira Service Management Operations — the supported successor to Opsgenie. | Jump to setup | |
| ServiceNow | Open incident records in ServiceNow directly from monitor and status page events. | Jump to setup |
Setting Up Email Notifications
Email channels support one or more recipients.
- Go to
/user/status-pages/notifications - Click Add Channel → Email
- Add recipient email addresses
- Save the channel
- Confirm the verification email (so it shows as Verified)
Setting Up Webhooks
Webhooks send an HTTP request to your endpoint.
- Go to
/user/status-pages/notifications - Click Add Channel → Webhook
- Enter the destination URL
- Choose the HTTP method (POST/PUT)
- (Optional) Add custom HTTP headers as JSON
- Save the channel
Payload format:
- Webhook sends JSON
{ "subject": "…", "message": "…" }by default. - Google Chat / Mattermost / Rocket.Chat send JSON
{ "text": "…" }.
Custom body template. For full control over the request body, add an optional
Body Template and Content Type when creating a webhook channel. The template
receives:
.Subject,.Message— the alert’s title and body.Severity—critical,warning,resolved, orinfo.Timestamp— RFC 3339, UTC.Fields— a map of the alert’s parsed key/value fields (e.g.{{ index .Fields "Monitor" }}).FieldList— the same fields, in order, as{Name, Value}pairs — use this if you need torangeover them
Example, for a service that expects {"text": "..."}:
{"text": "{{ .Subject }} ({{ .Severity }})\n{{ .Message }}"}
This is what lets the webhook channel talk directly to Zapier, Make, n8n, Home Assistant,
Alertmanager-compatible receivers, or any in-house consumer without a dedicated
integration for each. Leave the template empty to keep the default payload.
Setting Up Slack
Slack channels use a Slack App bot token and a Channel ID.
- Go to
/user/status-pages/notifications - Click Add Channel → Slack
- Paste your Bot Token (starts with
xoxb-) - Paste the target Channel ID (e.g.
C0XXXXXXXXX) - Ensure your bot is allowed to post in that channel (invite it if needed)
- Save the channel
Setting Up Discord
- Create a webhook in your Discord server settings
- Copy the Webhook URL
- In
/user/status-pages/notifications, add a Discord channel and paste the URL - Save, then send a test
Setting Up Telegram
Telegram supports two modes:
- Use Our Bot (Easy): you only provide your Chat ID
- Use Custom Bot: you provide a Bot Token + Chat ID
- Go to
/user/status-pages/notifications - Click Add Channel → Telegram
- Choose Use Our Bot or Use Custom Bot
- Get your Chat ID and paste it in
- If using Custom Bot, paste your Bot Token from
@BotFather - Save the channel and send a test
Setting Up Microsoft Teams
- Open the target Teams channel and create an incoming webhook
- Copy the webhook URL
- Add it as an MS Teams channel in
/user/status-pages/notifications - Verify delivery with a test notification
Setting Up Pushover
- Create a Pushover application and note the app token
- Copy your Pushover user key
- Add a Pushover channel in
/user/status-pages/notificationswith the token + user key - Send a test notification to validate the connection
Setting Up SMS
SMS notifications use your own provider account. Supported providers: Twilio, Vonage (Nexmo), MessageBird, Esendex.
- Go to
/user/status-pages/notifications - Click Add Channel → SMS
- Select your provider and enter the required credentials
- Enter a Sender / From Number and one or more Recipient Numbers (E.164 format)
- Configure cost controls (dedup window, daily limit) and select which events trigger an SMS
- Save and send a test
SMS messages are truncated to 160 characters. Per-provider message IDs are recorded in Notification History so you can look them up in your provider’s console.
For full setup instructions and troubleshooting, see SMS Notifications.
Setting Up PagerDuty
PagerDuty integration uses the Events API v2 to trigger and auto-resolve incidents.
- In PagerDuty, create or open a Service
- Add an Events API v2 integration to that service
- Copy the Integration Key (also called Routing Key)
- In
/user/status-pages/notifications, add a PagerDuty channel and paste the key - Save and send a test notification
How events map to PagerDuty:
- Monitor Down / Heartbeat Missed / New Incident -> triggers a PagerDuty incident (severity: critical)
- Response Degraded -> triggers a PagerDuty incident (severity: warning)
- Monitor Recovered / Incident Resolved / Heartbeat Recovered -> resolves the PagerDuty incident
- Maintenance -> triggers a PagerDuty incident (severity: info)
For a detailed guide, see PagerDuty Integration.
Setting Up Google Chat
Google Chat uses an incoming webhook URL. This channel type uses the same fields as Webhook (URL, method, optional headers), but sends a { "text": "…" } JSON payload.
- Create an incoming webhook in Google Chat
- Copy the webhook URL
- Add a Google Chat channel in
/user/status-pages/notifications - Save and send a test
Setting Up Mattermost
Mattermost uses an incoming webhook URL. This channel type uses the same fields as Webhook (URL, method, optional headers), but sends a { "text": "…" } JSON payload.
- Create an incoming webhook in Mattermost
- Copy the webhook URL
- Add a Mattermost channel in
/user/status-pages/notifications - Save and send a test
Setting Up Rocket Chat
Rocket.Chat uses an incoming webhook URL. This channel type uses the same fields as Webhook (URL, method, optional headers), but sends a { "text": "…" } JSON payload.
- Create an incoming webhook in Rocket.Chat
- Copy the webhook URL
- Add a Rocket.Chat channel in
/user/status-pages/notifications - Save and send a test
Setting Up ntfy
ntfy is a simple pub-sub push service. Use the public ntfy.sh server or point it at your own self-hosted instance — no account required either way.
- Pick a topic name. Anyone who knows the topic can read it, so choose something unguessable (not “alerts”)
- (Optional) Set a Server URL if you’re self-hosting; leave blank to use
https://ntfy.sh - (Optional) Add an Access Token if your topic requires authentication
- Add an ntfy channel in
/user/status-pages/notificationswith these values - Subscribe to the topic in the ntfy app or web client, then save and send a test
Setting Up Gotify
Gotify is a self-hosted push notification server.
- Create an application in your Gotify server and copy its Application Token
- Add a Gotify channel in
/user/status-pages/notificationswith your Server URL and the application token - Save and send a test notification
Setting Up Matrix
Post alerts into a room on your own Matrix homeserver.
- Get the Room ID for the target room (starts with
!, e.g.!abcdef:matrix.org) - Create an access token for a bot/service account on your homeserver
- Add a Matrix channel in
/user/status-pages/notificationswith the Homeserver URL, Room ID, and Access Token - Save and send a test
Setting Up WhatsApp
WhatsApp alerts use your own Twilio account and WhatsApp sender.
- Set up a WhatsApp sender in your Twilio console
- Add a WhatsApp channel in
/user/status-pages/notificationswith your Twilio Account SID, Auth Token, sender number, and recipient numbers (E.164 format) - Save and send a test
Twilio only allows free-form business-initiated messages within 24 hours of the recipient’s last reply. Outside that window, your Twilio account must use a pre-approved message template — configure this on the Twilio side.
Setting Up Voice Call
An automated call that reads the alert headline aloud, twice — the escalation path for when a push notification alone isn’t enough to wake someone up. Reserve this for critical events.
- Add a Voice Call channel in
/user/status-pages/notificationswith your Twilio Account SID, Auth Token, caller number, and recipient numbers (E.164 format) - Save and send a test — you should receive a call reading the alert aloud
Setting Up Jira Service Management
Jira Service Management (JSM) Operations is the supported successor to Opsgenie for triggering and resolving on-call alerts.
- In Atlassian, note your Cloud ID, your account email, and generate an API token
- Add a Jira Service Management channel in
/user/status-pages/notificationswith those three values - Save and send a test notification
Alerts use the same alias-based dedup as PagerDuty, so a recovery closes the alert its outage opened instead of stacking a new one.
Setting Up ServiceNow
Open an incident record in your ServiceNow instance directly from monitor and status page events.
- Create (or reuse) an integration user in ServiceNow with permission to create incidents
- Add a ServiceNow channel in
/user/status-pages/notificationswith your Instance URL and the integration user’s credentials - Save and send a test — a new incident record should appear in your instance
Testing Notifications
Always test your channels before relying on them:
- Go to
/user/status-pages/notifications - Click Test next to any channel
- Verify you receive the test notification
- If not, check your configuration
Linking Channels to Status Pages
After you create channels, you enable them per status page:
- Open your status page settings:
/user/status-pages/{status_page_id}/settings#notifications - Click Link Channel
- Select a channel and link it
- Toggle channels on/off for that status page
You can also set component notification overrides to use a different set of channels for a specific component.
Notification Hub - Unified Management
The Notification Hub provides a centralized view of all your notification channels and status pages in one place.
Using the Notification Hub
- Go to Notification Hub in the left menu
- Direct URL:
/user/notifications/hub
- Direct URL:
- View the Channel × Status Page matrix
- Click a status page name to jump to its notification settings
For more details, see Notification Hub Guide.
Best Practices
| Do | Don’t |
|---|---|
| Use multiple channels for critical services | Rely on a single channel |
| Test regularly | Assume channels are working |
| Keep at least one email channel enabled | Make chat apps your only delivery path |