> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.komo.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Notifications

> Set up workspace notifications to stay informed about important events like workflow errors

<Note>
  Notifications is currently in **beta**. You can start using it today — features and event types may expand over time.
</Note>

Notifications let you monitor important events in your workspace and receive alerts through configured delivery channels. Use them to stay informed about issues like workflow execution errors without manually checking the platform.

## Overview

The Notifications settings page has two tabs:

* **Notifications** — define what events you want to be notified about and how frequently
* **Channels** — configure where notifications are delivered (for example, email)

Navigate to **Workspace Settings > Notifications** in the sidebar to get started.

## Channels

Channels define where your notifications are delivered. You need at least one active channel before you can create notification subscriptions.

### Creating a channel

<Steps>
  <Step title="Open the Channels tab">
    Go to **Workspace Settings > Notifications** and select the **Channels** tab.
  </Step>

  <Step title="Add a channel">
    Click **Add Channel** to open the channel creation form.
  </Step>

  <Step title="Configure the channel">
    Enter a **Channel Name** to identify this channel (for example, "Team Alerts").

    Select a **Channel Type**:

    * **Email** — send notifications to one or more email addresses
  </Step>

  <Step title="Add recipients">
    For email channels, enter each recipient's email address and click **Add**. You can add multiple recipients to a single channel.
  </Step>

  <Step title="Save">
    Click **Create** to save the channel.
  </Step>
</Steps>

### Managing channels

You can edit existing channels to update the name or modify recipients. If a recipient address has delivery errors, a warning icon appears next to it with details about the failure.

## Notification subscriptions

Subscriptions define which events trigger a notification and which channels receive it.

### Creating a subscription

<Steps>
  <Step title="Open the Notifications tab">
    Go to **Workspace Settings > Notifications** and select the **Notifications** tab.
  </Step>

  <Step title="Add a notification">
    Click **Add Notification** to open the subscription creation form.
  </Step>

  <Step title="Name the subscription">
    Enter a **Subscription Name** (for example, "Workflow failure alerts").
  </Step>

  <Step title="Select an event type">
    Choose which event triggers the notification. Currently available:

    * **Flow Execution Error** — triggers when a workflow execution fails
  </Step>

  <Step title="Configure event settings">
    For workflow error notifications, choose the scope:

    * **All workflows in workspace** — receive alerts for errors in any workflow
    * **Specific workflows** — select individual workflows to monitor
  </Step>

  <Step title="Select channels">
    Choose one or more notification channels to deliver this alert. Only enabled channels with a valid status appear in the list.
  </Step>

  <Step title="Set a cooldown">
    Configure a **notification cooldown** to limit how frequently you receive alerts. The minimum cooldown is 5 minutes. This prevents notification spam when multiple errors occur in quick succession.
  </Step>

  <Step title="Save">
    Click **Create** to activate the subscription.
  </Step>
</Steps>

### Managing subscriptions

You can edit existing subscriptions to change the event scope, update channel assignments, or adjust the cooldown period.

## FAQ

<AccordionGroup>
  <Accordion title="What events can I subscribe to?">
    Currently, you can subscribe to **Flow Execution Error** events, which notify you when a workflow fails. More event types may be added as the feature evolves.
  </Accordion>

  <Accordion title="Can I send notifications to multiple channels at once?">
    Yes. When creating a subscription, you can select multiple channels. Each selected channel receives the notification independently.
  </Accordion>

  <Accordion title="What does the cooldown setting do?">
    The cooldown limits how often a notification fires for the same subscription. For example, with a 5-minute cooldown, if multiple workflow errors occur within that window, you receive one notification instead of many.
  </Accordion>

  <Accordion title="Why don't I see any channels when creating a subscription?">
    You need to create at least one channel in the **Channels** tab first. Only channels that are enabled and have a valid status appear as options.
  </Accordion>
</AccordionGroup>