n8n/packages/@n8n/workflow-sdk
Mutasem Aldmour 3297536011
refactor(core): Move node-specific builder guidance to per-node @builderHint (no-changelog) (#29992)
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-12 07:45:33 +00:00
..
scripts feat(core): Expand workflow-sdk test fixtures from 500 to 2000 workflows and fix codegen bugs (#26041) 2026-02-26 10:09:16 +00:00
src refactor(core): Move node-specific builder guidance to per-node @builderHint (no-changelog) (#29992) 2026-05-12 07:45:33 +00:00
test-fixtures feat(core): Accept merge.input(n) inside ifElse/switch branch targets in workflow-sdk (#29716) 2026-05-07 07:46:06 +00:00
.gitignore feat(ai-builder): Add code-base workflow builder (#24535) 2026-02-10 12:24:27 +00:00
eslint.config.mjs refactor: Rename node-level builderHint.message to searchHint and propertyHint (#30062) 2026-05-08 13:32:50 +00:00
jest.config.js feat(ai-builder): Add code-base workflow builder (#24535) 2026-02-10 12:24:27 +00:00
package.json 🚀 Release 2.21.0 (#30283) 2026-05-12 07:29:34 +00:00
README.md feat(ai-builder): Add code-base workflow builder (#24535) 2026-02-10 12:24:27 +00:00
tsconfig.build.json feat(ai-builder): Add code-base workflow builder (#24535) 2026-02-10 12:24:27 +00:00
tsconfig.json chore: Prepare tsconfigs for tsgo (#29230) 2026-04-27 12:30:22 +00:00

Banner image

@n8n/workflow-sdk

TypeScript SDK for programmatically creating n8n workflows.

Features

  • Fluent builder API for workflow creation
  • Full type safety with TypeScript
  • Code generation from JSON workflows
  • Control flow support (If, Switch, Merge, Loop)
  • Built-in validation
  • AI/LangChain node integration

Usage

import { WorkflowBuilder, manual, httpRequest } from '@n8n/workflow-sdk';

const workflow = new WorkflowBuilder()
  .withName('My Workflow')
  .addTrigger(manual())
  .then(httpRequest({ url: 'https://api.example.com/data' }))
  .build();

License

You can find the license information here