# How to setup notifications for Dataflows

## Overview

Dataflow Run Notifications allow admins to receive automatic email alerts whenever a Dataflow run succeeds or fails. 

**Key capabilities:**

* Get notified per Dataflow on run success, failure, or both
* Configure multiple email recipients by adding separate subscriptions
* Each subscription is independently configured with its own email and event preferences

## Setting Up Notifications

### Step 1 — Open a Dataflow

Navigate to Settings → AI and Automation → Data Flows. Open any existing configured Dataflow or create a new one.

![](/files/df0bab4fafda74f5a06fef60c8e420cd92db0ad6)

*Fig. 1 — An opened Dataflow showing the Configuration tab with Source, Transformation, and Destination sections*

### Step 2 — Go to the Notifications Tab

Inside the Dataflow, click the Notifications tab in the top navigation. If no notification subscriptions are configured yet, you will see an empty state with an Add subscription button.

![](/files/186d2ff5c5eaf03e722e9ce8f96dfc0bf3855617)

*Fig. 2 — Notifications tab with no subscriptions configured*

### Step 3 — Add a Subscription

Click Add subscription +. A subscription form will appear with the following fields:

* **Channel** — Currently Email (additional channels may be added in future releases)
* **Email address** — The email address that should receive notifications for this subscription
* **Events** — Choose Run succeeded, Run failed, or both

![](/files/fa8d33379b4b6b73919957e5a5050c2081e1f49b)

*Fig. 3 — A single subscription configured with both Run succeeded and Run failed events selected*

### Step 4 — Save Your Notifications

Once you have configured the subscription, click Save Notifications in the top right corner. The settings are not applied until saved.

| 💡 **Note:** The Save Notifications button becomes active only after a change is made. Always save before navigating away from the tab. |
| --------------------------------------------------------------------------------------------------------------------------------------- |

## Notifying Multiple Email Addresses

Each email recipient requires a separate subscription. To add additional recipients:

1. Click Add subscription + again after saving the first subscription
2. Enter the new email address in the Email address field
3. Select the events this recipient should be notified for (can differ per recipient)
4. Click Save Notifications

The example below shows two subscriptions: one recipient subscribed to both events, and a second recipient subscribed to Run failed only.

![](/files/17082d2af2759dc60a3ca8e580de2a42369583a1)

*Fig. 4 — Two subscriptions configured: Subscription 1 receives both events; Subscription 2 receives Run failed only*

## Notification Events Reference

| **Event**         | **Description**                                                         | **Recommended For**                                           |
| ----------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------- |
| **Run succeeded** | Triggered when a Dataflow run completes without errors                  | Audit trails, confirming scheduled imports ran successfully   |
| **Run failed**    | Triggered when a Dataflow run encounters an error and does not complete | Operational monitoring, alerting on-call teams to take action |

## Frequently Asked Questions

#### Can I notify different emails for success vs. failure?

Yes. Add separate subscriptions per email and check only the relevant event for each. For example, Subscription 1 can be configured for Run succeeded only, and Subscription 2 for Run failed only — each going to a different address.

#### Is there a limit on the number of subscriptions per Dataflow?

There is no documented limit. You can add as many subscriptions as needed for a given Dataflow.

#### Do notifications apply to manually triggered runs as well as scheduled ones?

Yes. Notifications fire on every run regardless of whether it was triggered manually via the Run button or through a configured schedule.

#### How do I stop receiving notifications?

Navigate to the Notifications tab on the relevant Dataflow, click the delete (trash) icon on the subscription you want to remove, and save.

#### I don't see an option to configure notifications on my dataflows

Reach out to Support from within the platform - Left Nav Bar >> Help >> Create Case 


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bird.com/applications/automation/data-flows/how-to/how-to-setup-notifications-for-dataflows.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.