Contributed by Sabrina Ramonov 🍄. From the community directory at agents.sabrina.dev, republished with permission and full credit.
Analyze and Diagnose n8n Workflow Errors Automatically via OpenAI and Email
This template is available on Cloud & self-hosted n8n instances with the OpenAI node enabled.
Who is this for?
This workflow is designed for n8n developers, automation engineers, and DevOps teams who want to automatically capture and analyze workflow errors, and receive professional HTML-styled diagnostics directly in their inbox.
What problem does this solve?
Manually troubleshooting failed workflows in n8n can be time-consuming. This template streamlines error detection by:
- Capturing workflow failures using the Error Trigger node
- Diagnosing root causes with the help of OpenAI
- Sending a fully-formatted, human-readable HTML error report via email
- Including practical resolutions and next-step suggestions
This helps you or your team resolve issues faster and avoid repeated manual debugging.
What this workflow does
Triggers on any n8n workflow error
Extracts relevant error metadata including node, execution ID, and timestamps
Sends error content to OpenAI for analysis and recommendations
Generates an HTML email report with inline styles and clear formatting
Emails the result to a system administrator or support email
Setup
- Install the OpenAI node in your self-hosted n8n instance.
- Add your OpenAI API Key securely in credentials.
- Configure the SMTP Email node with your email credentials.
- Adjust the Error Trigger to monitor specific workflows or all workflows.
- Set your preferred admin or dev email address in the final node.
How to customize this workflow to your needs
Use a Set node to define your variables, such as:
- Default admin email
- Workflow filter (optional)
Customize the prompt sent to OpenAI if you want deeper or more specific analysis.
Modify the email HTML styles to match your brand or internal format.
Add additional logging (e.g., to Airtable, Google Sheets, or Notion) for long-term error tracking.
Sticky NoteTitle: Automated Error Reporter with AI-Powered DiagnosisDescription: Captures any n8n error, sends it to OpenAI, and emails a beautiful HTML report to the administrator with steps to resolve the issue. Requires OpenAI credentials and SMTP configured.
Tools used: OpenAI, SMTP Email
Download the workflow template (JSON)
Want this running in your business? KOBA42 builds and operates automations like this one.