When any n8n workflow fails, this setup writes a clear incident email and sends it through Gmail. It gives teams fast answers about what broke and how to fix it without digging through long logs.

The flow starts with an Error Trigger that fires on failure. It fetches the full failed execution from the n8n API using the execution id. An If step can ignore manual test runs to cut noise. A Code step extracts the error message, node name, stack, and context. An OpenAI Chat Model reviews these details and returns three fields in a fixed format diagnosis, cause, and resolution. The values are stored, then another Code step builds an easy to read subject and HTML body. The Gmail node sends the email to the addresses you set, with optional CC and BCC. Sticky notes in the canvas point to where to set emails and how to handle manual runs.

You will need OpenAI, Gmail, and n8n credentials. After setup, teams can cut triage time, reduce alert noise, and move faster on fixes. This is useful for IT and ops groups that maintain many automations, agencies that manage client workflows, and solo builders who want helpful alerts at any hour.

• Error Trigger captures failed n8n executions the moment they occur
• n8n API node pulls full execution data using the execution id
• If node can skip manual runs to reduce noisy test alerts
• Code step extracts key error details and context for analysis
• OpenAI Chat Model returns a structured diagnosis, cause, and resolution
• Set step maps AI output into clean fields for downstream use
• Code step builds a clear subject line and HTML email body
• Gmail node sends TO, CC, and BCC to the addresses you provide

• Reduce triage time from 20 minutes to 2 minutes
• Automate 100 percent of failure alert emails
• Improve fix accuracy by 30 percent with AI diagnosis
• Cut alert noise by ignoring manual tests by up to 80 percent
• Connect OpenAI, Gmail, and n8n in one simple flow
• Support dozens of workflows without extra setup time

1. Import the template into n8n: Create a new workflow in n8n > Click the three dots menu > Select 'Import from File' > Choose the downloaded JSON file.
2. You'll need accounts with OpenAI, Gmail and n8n. See the Tools Required section above for links to create accounts with these services.
3. Open the OpenAI Chat Model node. In the Credential to connect with menu, click Create new credential, then follow the on screen instructions. In your OpenAI account, create an API key and paste it when asked.
4. Open the Gmail node. In the Credential to connect with menu, click Create new credential and complete Google consent. Make sure the Gmail account has permission to send emails.
5. Open the n8n node that fetches executions. In the Credential to connect with menu, click Create new credential. In your n8n settings, create or retrieve an API token and enter it here.
6. Open the SET EMAIL node and update TO, CC, and BCC with your team addresses. Use a group email for TO to reach the right people quickly.
7. Decide how to handle manual runs. If you want alerts for tests, edit the Remove Manual Exec condition to allow manual mode. If you want only live errors, leave it as is.
8. Review the Error Solver Agent node. You can adjust the system message or keep the default. Test a sample error to see the diagnosis, cause, and resolution fields.
9. Activate this error handler workflow so it can catch failures from other workflows. Then run a small test workflow that throws an error to trigger it.
10. Check your Gmail inbox for the alert. Confirm the subject, HTML body, and structured fields look correct. Tweak the Generate Email code if you want different formatting.
11. If emails do not arrive, confirm Gmail credentials are connected, check spam, and verify that the workflow ran successfully. Review the execution log for any OpenAI errors or rate limits.
12. Once validated, keep the workflow active. Monitor OpenAI usage and adjust prompts or filters to balance detail and cost.