Package Information
Available Nodes
Documentation
@dszp/n8n-nodes-listmonk
n8n community node for the Listmonk email & newsletter API.
Overview
This node integrates the Listmonk admin API into n8n, providing access to all major resources:
- Subscribers — create, get, update, delete, manage lists, blocklist, export, bounces
- Lists — create, get, update, delete
- Campaigns — create, get, update, delete, status management, preview, analytics, test send
- Templates — create, get, update, delete, preview, set default
- Media — upload, get, delete
- Transactional — send transactional emails
- Import — import subscribers, check status, view logs
- Settings, Admin, Logs, Maintenance, Public — full admin API coverage
Installation
In your n8n instance, go to Settings > Community Nodes and install:
@dszp/n8n-nodes-listmonk
Or install via the CLI:
# Self-hosted n8n
cd ~/.n8n
npm install @dszp/n8n-nodes-listmonk
# Docker — add to your n8n environment
N8N_COMMUNITY_PACKAGES=@dszp/n8n-nodes-listmonk
Configuration
- In n8n, create a new Listmonk API credential
- Enter your Listmonk base URL (e.g.,
https://listmonk.example.com) — no trailing slash - Enter your admin username and password (HTTP Basic Auth)
The node makes requests to the admin API at {baseUrl}/api.
Compatibility
- Tested with Listmonk v6.0.0+
- Tested with n8n v2.11.3+
- Supports use as an AI agent tool (
usableAsTool: true)
Development
pnpm install # Install dependencies
pnpm build # TypeScript compile + copy icons
pnpm dev # Watch mode
pnpm test # Run tests
pnpm lint # Lint check
pnpm lint:fix # Auto-fix lint issues
make up-listmonk # Convert OpenAPI YAML to JSON
Local testing with n8n
make build && make link && make start
This builds, links the package globally, then starts n8n with the node available.
Architecture
Node properties are auto-generated from the bundled Listmonk OpenAPI spec using @devlikeapro/n8n-openapi-node. A custom ListmonkOperationParser maps the generated operation names to n8n conventions (Get, Create, Update, Delete, Get Many).
The OpenAPI spec has been enhanced beyond the upstream Listmonk spec with additional fields and endpoints not present in the official documentation.
Credits
This node builds on the work of several upstream authors:
- Originally created by Tobias Wiesing at
loopion/n8n-nodes-listmonk - Forked and extended by Martin Fenner at
front-matter/n8n-nodes-listmonk - Forked and extended by Sven Huijbrechts at
toSvenson/n8n-nodes-listmonk - Forked and rebranded by David Szpunar as
@dszp/n8n-nodes-listmonk