Channels
Channels are named destinations for your alerts. Each channel has a unique webhook URL and its own notification settings. Organize channels by service, environment, or alert type.
Creating a Channel
Click the + button in the sidebar to create a new channel. You'll need to provide:
Name
A descriptive name for the channel. Use names that make it clear what alerts you'll find here.
Icon
An emoji or character to identify the channel at a glance in the sidebar.
Category
An optional category to group related channels together. See the Categories section below.
Categories
Categories are folders that group related channels in the sidebar. They help keep your workspace organized as you add more channels.
Example Organization
Production
deploys
errors
payments
User Activity
signups
churn
support-tickets
Infrastructure
health-checks
disk-usage
cron-jobs
To create a category, go to your workspace settings and navigate to the Categories section. Channels can be assigned to a category when creating or editing them.
Webhook Token
Each channel has a unique webhook token that's part of its webhook URL. This token authenticates requests and routes alerts to the correct channel.
https://alerts.example.com/api/webhook/abc123def456ghi789
The highlighted part is the webhook token
Keep tokens secret
Treat webhook tokens like passwords. Store them in environment variables and never commit them to version control.
Regenerate if compromised
If a token is accidentally exposed, regenerate it from the channel settings. The old token will immediately stop working. Update the URL in all your integrations.
Notification Settings
Each channel can independently configure how you're notified when new alerts arrive. Open channel settings by clicking the gear icon in the channel header.
Sound Notifications
Play an audible notification sound when a new alert arrives in this channel. Works when the dashboard is open in your browser.
Desktop Notifications
Show a desktop push notification when new alerts arrive. Requires browser notification permissions. Works even when the dashboard tab is in the background.
Email Notifications
Send an email for every alert in this channel. Configure one or more recipient email addresses (comma-separated). Each recipient gets a formatted email with the alert details, fields, and any action links.
Channel Settings
Click the gear icon in the channel header to access channel settings. From here you can:
- Rename the channel or update its description
- Change the channel icon (emoji)
- Copy the webhook URL
- Regenerate the webhook token if compromised
- Configure notification preferences (sound, desktop, email)
- Delete the channel (permanently removes all alerts)
Best Practices
One channel per concern
Create separate channels for different alert types rather than mixing everything. A 'deploys' channel with only deployment alerts is more useful than a 'everything' channel.
Use descriptive names
Name channels by what they contain, not where they come from. 'payment-failures' is better than 'stripe-webhooks' because it describes the alert content.
Enable email for critical channels
For channels that receive high-priority alerts (errors, payment failures), enable email notifications so you're alerted even when you're not looking at the dashboard.
Use categories for scale
Once you have more than 5-6 channels, group them into categories. This keeps the sidebar manageable and helps team members find relevant channels.