n8n Workflow Auto Error Analysis & AI Fix Suggestions

Capture failures with Error Trigger → fetch workflow structure via n8n API → send to AI Agent through OpenRouter for root-cause analysis and fix steps → convert to HTML email and send via Gmail

Who

Operators or developers using n8n who need to monitor production workflow failures

You get

Automatically receive an email with AI root-cause analysis and step-by-step fix suggestions whenever a monitored n8n workflow fails during a production execution

You need

n8n · gmail

Steps

1. Prepare environment and credentials

   Complete the following prerequisites in your n8n instance: 1) Go to Settings > API and generate an API Key; 2) Ensure the instance has the N8N_EDITOR_BASE_URL environment variable set to your editor root URL (e.g., https://your-n8n.example.com); 3) Sign up for OpenRouter and obtain an API Key; 4) Prepare a Gmail account for OAuth2 authorization to send emails; 5) Confirm the recipient email address.

2. Import template and confirm Error Trigger

   Import this template from the n8n template marketplace. The first node is Error Trigger, the entry point that automatically activates when another workflow in your instance fails during a production execution. No additional parameters are required for this node.

3. Configure Get Workflow JSON node

   Open the "Get Workflow JSON" node (HTTP Request type). The URL is pre-filled with the expression: ={{`${$env.N8N_EDITOR_BASE_URL}/api/v1/workflows/${$json.workflow.id}`}}. In Credentials, select or create a "Generic Credential" of type httpHeaderAuth, set Header Name to X-N8N-API-KEY, and Value to your n8n API Key. Keep Response Format as JSON.

   Setup guidance · Source text。Headers configuration of the Get Workflow JSON node; Generic Credential httpHeaderAuth

   Copy prompt

   **Name:** `X-N8N-API-KEY`
   **Value:** API-KEY

4. Configure Debugger Agent and AI model

   Open the "Debugger Agent" node (AI Agent type) with promptType set to define. In the Model connection, select "Gemini 2.5 Pro" (OpenRouter Chat Model) and configure the openRouterApi credential in that model node. Then enter the following prompts:

   Execution prompt · Source text。Debugger Agent node Text (user prompt) field

   Copy prompt

   =A workflow has failed. Here is the data:
   
   ## Error Details
   - **Workflow Name:** {{ $json.name }}
   - **Failed Node Name:** {{ $('Error Trigger').item.json.execution.error.node.name }}
   - **Failed Node Type:** {{ $('Error Trigger').item.json.execution.error.node.type }}
   - **Error Message:** {{ $('Error Trigger').item.json.execution.error.message }}
   
   ## Full Workflow Structure (JSON)
   
   {{ JSON.stringify($('Get Workflow JSON').item.json) }}
   
   ---
   
   Based on all the information above, please provide the following in markdown format:
   
   ### Root Cause Analysis:
   A brief explanation of what likely caused this specific error in the context of the workflow. Analyze the failed node and the nodes that feed data into it.
   
   ### Suggested Fix:
   Provide clear, step-by-step instructions on how to fix the issue in the n8n editor. Be specific. For example, if it's a rate limit, suggest adding a "Wait" node. If it's a data mapping error, explain which expression is likely wrong.

   Execution prompt · Source text。Debugger Agent node System Message field

   Copy prompt

   =You are an expert n8n automation developer and debugger. Your task is to analyze a workflow error and provide a clear, actionable diagnosis and solution. Do not be conversational; provide the analysis directly in markdown.

5. Configure email formatting and delivery

   Open the "Convert Markdown To HTML" node, keep mode as markdownToHtml, set markdown to ={{ $json.output }}, and destinationKey to responseHtml. Then open the "Send Debugging Email" node (Gmail type): set sendTo to your recipient email; use the expression =N8N Automation Error (Workflow: {{ $('Get Workflow JSON').item.json.name }}) for subject; keep the template HTML expression for message, which includes a direct link to the failed execution, the affected node name and type, the error message, and the AI analysis result {{ $json.responseHtml }}. Configure gmailOAuth2 in Credentials.

6. Link target workflows and activate

   For each workflow you want to monitor: 1) Open the target workflow; 2) Click the "⋯" menu in the top right and select Settings; 3) In the Error Workflow dropdown, select this "AI-Powered Workflow Debugger & Notifier" workflow; 4) Click Save; 5) Ensure the target workflow is Active. Note: Error Trigger only fires on automatic executions (e.g., webhook or schedule), not on manual tests.

You are a setup assistant for an n8n automated debugging workflow. The user will import a template that automatically analyzes n8n workflow production failures using AI and sends an email report. Assist the user in this order: 1) Confirm readiness of n8n instance, N8N_EDITOR_BASE_URL, API Key, OpenRouter Key, and Gmail OAuth2; 2) Guide template import and verify the node chain: Error Trigger → Get Workflow JSON → Debugger Agent → Convert Markdown To HTML → Send Debugging Email; 3) Help fill in the Debugger Agent prompts and model credentials; 4) Instruct binding this debugger workflow in each target workflow's Settings > Error Workflow, then activate. Do not generate or send credentials on behalf of the user.