# Workflow Notifications

Stack AI can alert you when a workflow starts failing repeatedly, so you can catch broken workflows before they affect your users.

### How it works

Every time a workflow run fails, Stack AI tracks the number of consecutive failures. Once that count reaches a threshold, a notification is sent. The counter resets as soon as a run succeeds.

By default, you are notified after **3 consecutive failures**. The notification is sent via **email** and as an **in-app alert** (bell icon, top nav).

The email subject is `StackAI Flow Error Notification` and includes the workflow name and the number of consecutive failures. The in-app alert reads: *"Project \[name] failed N times in a row"* and links directly to the workflow's analytics page.

### Configuring notifications

There are two places where you can configure this:

#### 1. Account Settings → Notifications

**Where:** Click your avatar → Settings → Notifications

This is the global configuration for your organization. It controls two things:

* **Channels** — whether alerts are sent via Email, In-App, or both. Toggle these on or off per notification type in the table.
* **Threshold** — the number of consecutive failures before an alert fires. Click **Manage** (admins only) next to *Workflow Error* to change it from the default of 3.

Admins see two tabs:

* **Organization** — sets the defaults that apply to all workflows and all members. Only admins can edit this.
* **Personal** — lets each user override which channels they receive notifications on, regardless of the org default.

Non-admins only see the Personal tab.

<figure><img src="https://3697023207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFSlso1Kjob5CLDrh0dVn%2Fuploads%2FKfF8XHGMGnbWm2ykBIdx%2Fimage.png?alt=media&#x26;token=8468d9ac-ce11-4f4b-aad2-d0120542a9a2" alt=""><figcaption></figcaption></figure>

#### 2. Workflow Settings → Workflow Notifications

**Where:** Open a workflow → Settings icon (top-right) → Workflow Notifications tab

This lets you set a **per-workflow threshold** that overrides the org-level default for that specific workflow. For example, if the org default is 3 but this workflow is customer-facing, you can set it to 1 to be alerted on the first failure.

Click **Manage** next to *Workflow Error* to set the threshold for this workflow.

<figure><img src="https://3697023207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFSlso1Kjob5CLDrh0dVn%2Fuploads%2FpWOTKUb7mAnb5dVGmo83%2Fnotification.gif?alt=media&#x26;token=11b8e1c4-7e98-444f-b564-22c335bcbf2a" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
The per-workflow threshold only overrides the *when* — the channels (Email, In-App) are always controlled from Account Settings.
{% endhint %}

### Who gets notified

By default, notifications are sent to the **project creator** and all **organization admins**.

You can customize this from the **Manage** dialog in either the Account Settings or the Workflow Settings (described above). Both dialogs include a **Users to notify** field where you can select specific members of your organization. When set, notifications go to those users instead of the default recipients.