n8n-v2

name

n8n-v2

description

Comprehensive n8n v2.0 reference for building workflow automation. Use this skill when working with n8n workflows, especially for (1) creating workflow JSON files for import, (2) implementing human-in-the-loop approval workflows with Wait nodes, (3) troubleshooting Execute Sub-Workflow node issues, (4) setting up API credentials (LinkedIn, Anthropic, NewsAPI), (5) building orchestrator patterns with sub-workflows, (6) using expressions in nodes, (7) understanding MCP server limitations, or (8) any n8n workflow development task.

n8n v2.0 Workflow Development

Overview

Comprehensive reference for building n8n workflows using v2.0 patterns and best practices. This skill provides complete documentation for nodes, expressions, patterns, troubleshooting, and production-ready examples.

---

Quick Start Guide

1. Test APIs First

curl -X GET "https://api.example.com/endpoint" \
  -H "Authorization: Bearer $TOKEN"

2. Create Workflow JSON

Generate workflow JSON with nodes and connections.

3. Import into n8n

n8n UI > Settings > Import from File

4. Configure & Fix

• Replace Execute Sub-Workflow nodes (if needed)
• Configure credentials
• Test each node

5. Test Execution

Use MCP server mcp__n8n__execute_workflow or manual trigger

---

Core Concepts

n8n MCP Server Integration

What it CAN do:

• ✅ Search workflows
• ✅ View workflow details
• ✅ Execute workflows

What it CANNOT do:

• ❌ Create workflows
• ❌ Modify workflows
• ❌ Manage credentials

Workaround: Generate JSON files, import via UI

📖 Deep dive: references/mcp-limitations.md

---

Node Library

Complete reference for all n8n nodes:

Trigger Nodes: Manual Trigger, Execute Workflow Trigger Data Processing: Code, Set, Merge, Filter, Split in Batches Flow Control: IF, Wait Integration: HTTP Request, RSS Feed Read Action: Execute Workflow, Respond to Webhook

Each node documented with configuration examples, parameters, and patterns.

📖 Complete reference: references/node-library.md

---

Expression Syntax

Dynamic values in node parameters using ={{ expression }}:

{{ $json.field }}                      // Current item
{{ $('Node Name').first().json.field }} // Cross-node
{{ $json.url || 'default' }}           // Fallback
{{ new Date().toISOString() }}         // Date/time
`urn:li:person:${$json.sub}`          // Template literal

📖 Complete guide: references/expression-syntax.md

---

Common Workflows

Human-in-the-Loop Approval

Use Wait nodes with forms (NOT respondToWebhook):

Trigger → Generate Content → Wait Node (form) → IF → Action

📖 Complete patterns: references/wait-nodes-guide.md

---

Multi-Workflow Orchestration

Orchestrator coordinates sub-workflows:

Main Orchestrator
├── Trigger
├── Execute Sub-Workflow: Data Fetcher
├── Wait Node: Review
├── Execute Sub-Workflow: Processor
└── Execute Sub-Workflow: Output

📖 All patterns: references/workflow-patterns.md

---

News Aggregation

Multi-source data fetch, normalize, merge, deduplicate, rank:

Trigger
├── HTTP Request: Source 1 → Normalize
├── HTTP Request: Source 2 → Normalize
└── RSS Feed: Source 3 → Normalize
    → Merge → Deduplicate → Rank

📖 Detailed patterns: references/workflow-patterns.md

---

AI Content Generation

Sub-workflow pattern for AI content:

Execute Workflow Trigger
→ Code: Build Prompt
→ HTTP Request: AI API
→ Code: Extract Response

📖 Implementation: references/workflow-patterns.md

---

Critical Issues & Solutions

Execute Sub-Workflow "Out of Date" Error

Problem: Imported nodes show error after import

Solution:

1. Delete old Execute Sub-Workflow nodes
2. Add fresh nodes from palette
3. Select "Database" and choose workflow

📖 Detailed troubleshooting: references/execute-sub-workflow-issues.md

---

Wait Node Not Pausing

❌ Wrong: respondToWebhook, Set nodes, IF on unset fields ✅ Correct: Wait node with resume: "form"

📖 Complete guide: references/wait-nodes-guide.md

---

LinkedIn unauthorized_scope_error

❌ Turn OFF both: "Organization Support" and "Legacy" toggles

📖 All auth issues: references/api-credentials.md

---

Templates & Examples

Basic Templates

Starting points for common structures:

• assets/templates/wait-node-approval-template.json
• assets/templates/orchestrator-template.json
• assets/templates/sub-workflow-template.json

---

Complete Workflow Examples

Production-ready workflows you can import and use:

• News Aggregation - Multi-source fetch, normalize, deduplicate, rank assets/examples/news-aggregation-workflow.json

• Content Generation - AI-powered content creation sub-workflow assets/examples/content-generation-workflow.json

• LinkedIn Member ID - Retrieve your LinkedIn member URN assets/examples/linkedin-member-id-workflow.json

• Multi-Source Deduplication - Merge and deduplicate pattern assets/examples/multi-source-deduplication-workflow.json

---

Code Snippet Library

Reusable JavaScript for Code nodes:

• Deduplication - Remove duplicates by URL, title, ID, or multiple fields code-snippets/deduplication.js

• Ranking Algorithms - Multi-factor ranking (relevance, recency, engagement) code-snippets/ranking-algorithms.js

• Data Normalization - Unify data from different API sources code-snippets/data-normalization.js

• Form Data Preparation - Format data for Wait node forms code-snippets/form-data-preparation.js

• Cross-Node Data Access - Reference data from other nodes code-snippets/cross-node-data-access.js

---

API Credentials Quick Reference

LinkedIn OAuth2:

• Scopes: openid, profile, w_member_social
• ❌ OFF: Organization Support, Legacy
• URN format: urn:li:person:{id}

Anthropic API:

• Header: x-api-key
• Model: claude-3-5-sonnet-20241022
• Temp: 0.7, Max tokens: 400

NewsAPI:

• Header: X-Api-Key
• Endpoints: /v2/everything, /v2/top-headlines
• Free tier: 100 requests/day

📖 Complete setup: references/api-credentials.md

---

Reference Documentation

Core References

• node-library.md - Comprehensive node documentation
• expression-syntax.md - Complete expression guide
• workflow-patterns.md - Common workflow architectures
• wait-nodes-guide.md - Human-in-the-loop patterns
• api-credentials.md - Authentication setup
• mcp-limitations.md - MCP server constraints
• execute-sub-workflow-issues.md - Sub-workflow troubleshooting
• troubleshooting.md - Common issues and solutions

---

Official n8n Documentation

• n8n Documentation
• Execute Sub-Workflow Node
• Sub-workflows Guide
• Wait Node