Create notification channels

Notification channels are workspace destinations used by alarms. Create them before adding notifications to an alarm rule.

Each channel has a stable name. Alarms refer to channels by that name, so choose names that describe the destination, such as ops-email, incident-webhook, or checkout-oncall.

Open notification channels

Open Notification Channels from the Alarms section of the app.

The page shows existing channels, their type, target, verification status, and delete action.

Create an email channel

Use an email channel when alarm state changes should send email.

1. Enter a channel name.
2. Set Type to Email.
3. Enter the destination email address.
4. Select Create.

The app sends a verification code to the email address. The channel appears as Unverified until the code is confirmed.

Verify an email channel

Find the unverified email channel in the channel list.

Enter the six-digit verification code from the email and select Verify.

If the code expired or was lost, select Resend to send a new verification code.

Only verified email channels can be attached to an alarm. An unverified channel can appear in the channel list and alarm form, but the API rejects an alarm that references it.

Create a webhook channel

Use a webhook channel when alarm state changes should call an HTTP endpoint.

1. Enter a channel name.
2. Set Type to Webhook.
3. Enter the webhook URL.
4. Select Create.

Webhook channels do not require email-style verification. Make sure the destination URL is stable and controlled by the system that should receive alarm notifications.

Use channels in alarms

When creating an alarm, use Notification Channels to select the destinations for alarm state changes.

The alarm form lists the channels available in the current workspace. Check each channel that should receive notifications. You no longer need to type channel names manually.

The alarm sends notifications to those channels when its state changes.

Verify email channels before selecting them from alarms. Webhook channels do not require verification.

Delete a channel

Use Delete on the channel row to remove a notification channel. A channel cannot be deleted while an alarm references it; edit those alarms to remove the channel first.

Permissions

Creating, verifying, resending, and deleting notification channels require workspace permissions for notification channel actions.

See Create and use roles for custom role policies, and Create an alarm for adding channels to alarm rules.