Workflow Failure Notifications

Workflow failure notifications automatically send email alerts when a workflow execution fails, helping teams catch and respond to issues quickly. Notifications go to the workflow owner by default, with the option to add more recipients per workflow.

Prerequisites

• SMTP must be configured for your team (On-premises only). Super Admins manage platform SMTP under Email Configuration (SMTP).
• Workflow failure notifications must be enabled at the team level
• Recipients must be members of the workflow's project

Access Requirements

Action	Required Access
Enable or disable notifications for the team	Teams Administrator
Configure additional recipients for a workflow	Access to the workflow + project membership

Setup

Step 1 — Enable Notifications for the Team

A Teams Administrator must enable workflow failure notifications before any emails are sent.

1. Open team settings

   Go to My Account → Settings.

2. Enable notifications

   Locate Enable Email Notification and toggle it on.

3. Save

   Save the configuration.

Once enabled, workflow owners automatically receive email notifications when their workflows fail — no additional setup required.

Step 2 — Configure Additional Recipients (Optional)

Workflow owners can add more recipients for individual workflows.

1. Open the workflow

   Navigate to the workflow you want to configure.

2. Open Failure Notifications

   Click the kebab menu (⋯) and select Failure Notifications.

3. Add recipients

   Use the recipient dropdown to select additional users and save the configuration.

Failure Notification Modal

The modal that opens from Failure Notifications includes:

Component	Description
Notify Workflow Owner toggle	Enable or disable notifications for the workflow owner
Owner email	Displays the workflow owner's email address
Additional recipients dropdown	Multi-select dropdown for adding more recipients
Warning banner	Appears when team-level notifications are disabled

Recipient Rules

• Only project members can be selected as recipients
• The workflow owner is automatically excluded from the dropdown to avoid duplicate notifications
• Multiple recipients can be selected simultaneously
• Recipient lists are scoped to the current team

note

If a warning banner appears in the modal, team-level notifications are disabled. A Teams Administrator must enable them from My Account → Settings → Enable Email Notification before any notifications will be sent.

How Notifications Work

When a workflow execution fails:

1. The system detects the failure
2. Recipients are resolved — the workflow owner plus any additional configured recipients
3. Email notifications are sent to all resolved recipients

Best Practices

• Enable notifications only for actively monitored teams
• Add only relevant stakeholders as recipients — too many recipients leads to alert fatigue
• Review recipient lists periodically, especially after team membership changes
• Verify that your organization's spam filters do not block notification emails
• Ensure SMTP configuration remains valid

Troubleshooting

A user doesn't appear in the recipient dropdown

The user is not a member of the workflow's project. Add them to the project and retry.

Warning banner appears in the modal

Team-level notifications are disabled. A Teams Administrator must enable them from My Account → Settings → Enable Email Notification.

No email received after a failure

Check the following:

• SMTP is configured and active
• Team-level notifications are enabled
• The recipient's email address is valid
• Application logs show no email delivery errors
• Organization spam filters are not blocking notification emails