> For the complete documentation index, see [llms.txt](https://docs.couchdrop.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.couchdrop.io/automations/notifications.md).

# Notifications

Learn about notifications as part of automations

## Overview

Notifications let you send email alerts when a workflow action succeeds or fails.

They are useful when someone needs visibility into an automated process without reviewing the workflow execution logs. For example, you can notify an operations team when a transfer fails or confirm to a recipient that a scheduled process completed successfully.

Notifications can be added at any point in a workflow.

## Adding a notification

In the Automation Builder, click the **+** where you want the notification to run, then select **Notifications**.

Configure the notification using the following settings:

<table><thead><tr><th width="228.640625">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Send email on success</strong></td><td>Sends the notification when the preceding workflow action succeeds.</td></tr><tr><td><strong>Send email on failure</strong></td><td>Sends the notification when the preceding workflow action fails.</td></tr><tr><td><strong>Recipient Email Address</strong></td><td>The email address that will receive the notification. Enter multiple addresses as a comma-separated list.</td></tr></tbody></table>

You can enable both **Send email on success** and **Send email on failure** if the recipient should be notified regardless of the outcome.

{% hint style="info" %}
Notifications are added within the workflow, so their position determines which part of the workflow they report on.
{% endhint %}

### Recipient email addresses

Enter the email address that should receive the notification in **Recipient Email Address**.

To notify multiple recipients, separate each email address with a comma.

For example:

`operations@example.com, finance@example.com`

## Email template

Couchdrop uses a pre-filled email template for workflow notifications. The exact content varies depending on the event, but notifications follow a structure similar to:

**Subject:** `[Company name] - [Event] notification`

> Hi there,
>
> Just wanted to let you know that your file `[full file path]` pulled by `[username]` has been `[event]` from `[directory]`.
>
> If you require support or assistance with this please email us on <support@couchdrop.io> and someone will be in contact shortly.
>
> Thank you,
>
> Team @ Couchdrop

The company name shown in the subject is taken from the company name configured in Couchdrop Admin settings.

## When to use notifications

Notifications are useful when a workflow outcome needs to be surfaced outside Couchdrop.

Common examples include:

* Alerting an administrator when a transfer fails.
* Confirming that an automated transfer completed successfully.
* Notifying several operational stakeholders about the result of a workflow action.

For more detailed information about an individual workflow run, use the Automation execution logs, which provide the full execution details and error information.
