Failure Notifications

Overview

Failure Notifications alert you in real time when a workflow execution fails. Instead of checking the dashboard manually, you receive an email with error details and a direct link to the execution logs, plus an in-app notification in the bell icon. Each agent has independent notification settings, so you control exactly which automations send alerts and who receives them.

Setup

1. Navigate to your agent's detail page (Dashboard → Agents → select an agent)
2. Scroll to the Failure Notifications section
3. Toggle Enabled to turn on notifications
4. Select Notification Channels: Email, In-App, or both
5. Choose Recipients from your workspace members
6. Click Save Settings

Notification Channels

• Email — Sends an email with the agent name, workflow name, error message, and a “View Execution Logs” button that links directly to the failed execution. Emails are sent from Falcon Builder <notif@falconbuilder.dev>.
• In-App — Adds a notification to the bell icon in the top navigation bar. Unread notifications show a count badge. Click any notification to navigate directly to the execution details.

Configuration Details

• Per-agent settings — Each agent has independent notification configuration. Enable alerts for critical production agents while leaving development agents silent.
• Multiple recipients — Select any workspace member as a recipient. Choose specific team members who should be notified based on agent ownership or responsibility.
• Non-blocking — Notification delivery never interferes with workflow execution. If email sending fails, the error is logged but does not affect the workflow.

Email Contents

Each failure email includes:

• Agent name — which agent the failure occurred in
• Workflow name — the specific workflow that failed
• Error message — the error that caused the failure
• Execution ID — for tracking and support reference
• Direct link — a “View Execution Logs” button that opens the execution details page with full node-by-node logs

Availability

Failure Notifications are available on every Falcon Builder plan, including Free. There are no limits on the number of notifications sent.