# @n8n/workflow-sdk

> TypeScript SDK for programmatically creating n8n workflows

Latest version **0.34.2** (published 2026-10-01) · SEE LICENSE IN LICENSE.md license · 0 weekly downloads

## Install

```sh
npm install @n8n/workflow-sdk
pnpm add @n8n/workflow-sdk
yarn add @n8n/workflow-sdk
bun add @n8n/workflow-sdk
```

Provides the command `workflow-sdk`.

## Health

**Score 85/100 (A)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score; popular repo; extremely popular.

Warnings: low downloads; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.34.2 |
| Published | 2026-10-01 |
| First published | 2026-02-16 |
| Weekly downloads | 0 |
| License | SEE LICENSE IN LICENSE.md |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 8 |
| Unpacked size | 2.5 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 206604 |
| Author | Jan Oberhauser |
| Maintainers | cornelius_n8n_io, n8n-matsuuu, tomin8n, jan_n8n_io, n8n-charliekolb |

## Links

- npm: https://www.npmjs.com/package/@n8n/workflow-sdk
- Repository: https://github.com/n8n-io/n8n
- Homepage: https://n8n.io
- npm.io page: https://npm.io/package/@n8n/workflow-sdk

## Dependencies (8)

- [zod](https://npm.io/package/zod.md) 3.25.76
- [uuid](https://npm.io/package/uuid.md) 11.1.1
- [acorn](https://npm.io/package/acorn.md) 8.14.0
- [lodash](https://npm.io/package/lodash.md) 4.18.1
- [@n8n/utils](https://npm.io/package/@n8n/utils.md) 1.48.1
- [n8n-workflow](https://npm.io/package/n8n-workflow.md) 2.41.2
- [@dagrejs/dagre](https://npm.io/package/@dagrejs/dagre.md) ^1.1.4
- [@n8n/constants](https://npm.io/package/@n8n/constants.md) 0.39.1

## Recent versions

- 0.34.2 (latest) — 2026-10-01
- 0.35.2 (beta) — 2026-10-01
- 0.34.1 — 2026-09-30
- 0.35.1 — 2026-09-30
- 0.35.0 — 2026-09-29
- 0.34.0 — 2026-09-22
- 0.32.3 — 2026-09-18
- 0.32.2 — 2026-09-16
- 0.33.1 — 2026-09-16
- 0.33.0 — 2026-09-15
- 0.32.1 — 2026-09-10
- 0.32.0 — 2026-09-08
- 0.30.4 — 2026-09-04
- 0.30.3 — 2026-09-03
- 0.30.2 — 2026-09-02
- … 84 more at https://npm.io/package/@n8n/workflow-sdk/versions

## README

![Banner image](https://user-images.githubusercontent.com/10284570/173569848-c624317f-42b1-45a6-ab09-f0ea3c247648.png)

# @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

```typescript
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](https://github.com/n8n-io/n8n/blob/master/README.md#license)

---
_Source: https://npm.io/package/@n8n/workflow-sdk · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._