n8n Workflow Builder

Setup

Requires two environment variables:

• N8N_URL — n8n instance URL (e.g. https://your-n8n.example.com)
• N8N_API_KEY — n8n API key (Settings → API → Create API Key)

Workflow

1. Understand the automation — Clarify trigger (webhook/schedule/manual), data sources, processing logic, outputs, and error handling needs.

2. Design the workflow JSON — Build valid n8n workflow JSON following the schema in references/workflow-schema.md. Use patterns from references/workflow-patterns.md as templates.

3. Deploy via API — Use scripts/n8n-api.sh create <file> or pipe JSON to scripts/n8n-api.sh create-stdin.

4. Activate — Use scripts/n8n-api.sh activate <workflow_id> for trigger-based workflows.

5. Verify — List workflows to confirm deployment: scripts/n8n-api.sh list.