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.

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

Available Channel Types

Setting Up Email Notifications

Email channels support one or more recipients.

1. Go to /user/status-pages/notifications
2. Click Add Channel → Email
3. Add recipient email addresses
4. Save the channel
5. Confirm the verification email (so it shows as Verified)

Setting Up Webhooks

Webhooks send an HTTP request to your endpoint.

1. Go to /user/status-pages/notifications
2. Click Add Channel → Webhook
3. Enter the destination URL
4. Choose the HTTP method (POST/PUT)
5. (Optional) Add custom HTTP headers as JSON
6. Save the channel

Payload format:

• Webhook sends JSON { "subject": "…", "message": "…" }.
• Google Chat / Mattermost / Rocket.Chat send JSON { "text": "…" }.

Setting Up Slack

Slack channels use a Slack App bot token and a Channel ID.

1. Go to /user/status-pages/notifications
2. Click Add Channel → Slack
3. Paste your Bot Token (starts with xoxb-)
4. Paste the target Channel ID (e.g. C0XXXXXXXXX)
5. Ensure your bot is allowed to post in that channel (invite it if needed)
6. Save the channel

Setting Up Discord

1. Create a webhook in your Discord server settings
2. Copy the Webhook URL
3. In /user/status-pages/notifications, add a Discord channel and paste the URL
4. 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

1. Go to /user/status-pages/notifications
2. Click Add Channel → Telegram
3. Choose Use Our Bot or Use Custom Bot
4. Get your Chat ID and paste it in

• Here’s how you can get your Chat ID

5. If using Custom Bot, paste your Bot Token from @BotFather
6. Save the channel and send a test

Setting Up Microsoft Teams

1. Open the target Teams channel and create an incoming webhook
2. Copy the webhook URL
3. Add it as an MS Teams channel in /user/status-pages/notifications
4. Verify delivery with a test notification

Setting Up Pushover

1. Create a Pushover application and note the app token
2. Copy your Pushover user key
3. Add a Pushover channel in /user/status-pages/notifications with the token + user key
4. Send a test notification to validate the connection

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.

1. Create an incoming webhook in Google Chat
2. Copy the webhook URL
3. Add a Google Chat channel in /user/status-pages/notifications
4. 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.

1. Create an incoming webhook in Mattermost
2. Copy the webhook URL
3. Add a Mattermost channel in /user/status-pages/notifications
4. 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.

1. Create an incoming webhook in Rocket.Chat
2. Copy the webhook URL
3. Add a Rocket.Chat channel in /user/status-pages/notifications
4. Save and send a test

Testing Notifications

Always test your channels before relying on them:

1. Go to /user/status-pages/notifications
2. Click Test next to any channel
3. Verify you receive the test notification
4. If not, check your configuration

Linking Channels to Status Pages

After you create channels, you enable them per status page:

1. Open your status page settings: /user/status-pages/{status_page_id}/settings#notifications
2. Click Link Channel
3. Select a channel and link it
4. 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

1. Go to Notification Hub in the left menu
   • Direct URL: /user/notifications/hub
2. View the Channel × Status Page matrix
3. Click a status page name to jump to its notification settings

For more details, see Notification Hub Guide.

Best Practices

What’s Next?

• Notification Hub guide
• Manage status page subscribers
• Set up your first monitor