Description
n8n-nodes-planka-kanban
n8n community node for Planka v2. It exposes the full Planka REST API (100 endpoints) for workflow automation — projects, boards, cards, custom fields, attachments, notifications, users, webhooks, and more.
Published by filcuk on npm.
n8n is a fair-code licensed workflow automation platform.
Installation
Follow the n8n community nodes installation guide.
Self-hosted n8n — install from npm:
npm install n8n-nodes-planka-kanban
Or search for Planka in Settings → Community nodes and install n8n-nodes-planka-kanban.
> Note: This package replaces the earlier community node n8n-nodes-plankav2 (v0.x, partial API coverage). Use n8n-nodes-planka-kanban for full Planka v2 API support.
Credentials
Create Planka API credentials with:
| Field | Description |
|——-|————-|
| Base URL | Your Planka instance URL (e.g. https://planka.example.com) |
| Authentication | Email & password, or API key |
| Email or Username | Planka login (password auth) |
| Password | Planka password (password auth) |
| API Key | User API key via X-Api-Key header |
API keys can be created in Planka via User → Create API Key (or using this node’s User resource).
Resources
The node provides 26 resources covering all Planka v2 API endpoints:
| Resource | Operations |
|———-|————|
| Project | Create, Get, Get Many, Update, Delete |
| Board | Create, Get, Update, Delete |
| List | Create, Get, Update, Delete, Clear, Move Cards, Sort |
| Card | Create, Get, Get Many, Update, Delete, Duplicate, Mark Notifications Read |
| Comment | Create, Get Many, Update, Delete |
| Label | Create, Update, Delete, Add to Card, Remove From Card |
| Tasklist | Create, Get, Update, Delete |
| Task | Create, Update, Delete |
| Board Membership | Create, Update, Delete |
| Card Membership | Add, Remove |
| Action | Get Board Actions, Get Card Actions |
| Attachment | Create (file/link), Update, Delete |
| Notification | Get Many, Get, Update, Mark All Read |
| Base Custom Field Group | Create, Update, Delete |
| Custom Field Group | Create on Board/Card, Get, Update, Delete |
| Custom Field | Create in Base/Group, Update, Delete |
| Custom Field Value | Set, Clear |
| Project Manager | Create, Delete |
| Background Image | Upload, Delete |
| Notification Service | Create for Board/User, Update, Delete, Test |
| Access Token | Accept Terms, Exchange OIDC, Logout, Revoke Pending |
| Bootstrap | Get |
| Term | Get |
| User | Create, Get Many, Get, Update, Delete, Update Email/Username/Password, Create API Key, Upload Avatar |
| Config | Get, Update, Test SMTP |
| Webhook | Create, Get Many, Update, Delete |
Card → Get Many supports pagination plus optional filters: search, userIds, labelIds.
File uploads (attachments, background images, avatars) require a binary input — set the Binary Property field to the property name containing the file.
Compatibility
- Planka: v2.x API (Swagger reference)
- n8n: Tested with n8n 1.x / Node.js 22+
- Node package API version: 1
Development
git clone https://github.com/filcuk/n8n-nodes-planka-v2.git
cd n8n-nodes-planka-v2
npm install
npm run dev
| Script | Description |
|——–|————-|
| npm run dev | Start n8n with hot reload |
| npm run build | Production build to dist/ |
| npm run lint | Run n8n node linter |
| npm run lint:fix | Auto-fix lint issues |
Publishing
Automated (recommended)
Publishing runs when you create a GitHub Release:
1. Bump the version in package.json and tag the release (e.g. v1.1.2).
2. Publish the release on GitHub — the Publish workflow will:
– Publish @filcuk/n8n-nodes-planka-kanban to GitHub Packages
– Publish n8n-nodes-planka-kanban to npm if the NPM_TOKEN repository secret is set
To enable npm publishing from CI, add an npm access token as the NPM_TOKEN secret in Settings → Secrets and variables → Actions.
If GitHub Packages publish succeeds but you do not see the package on the repository:
1. Check your account packages first — https://github.com/filcuk?tab=packages (look for n8n-nodes-planka-kanban). New packages are private by default.
2. Link the package to the repo — open the package → Package settings → connect or grant access to filcuk/n8n-nodes-planka-v2.
3. Change visibility if needed — Package settings → Change visibility to public.
4. Actions summary — after a successful run, the workflow summary includes direct links to the package page.
5. Re-publish with a new version — bump package.json and create a new release (you cannot republish an existing version).
Manual
npm login # as filcuk on npmjs.com
npm publish
prepublishOnly runs build and lint automatically before publish.
To publish to GitHub Packages manually, scope the name and authenticate with a GitHub token:
npm pkg set name=@filcuk/n8n-nodes-planka-kanban
npm publish --registry=https://npm.pkg.github.com
