Package Information
Available Nodes
Documentation generating…
Documentation
@leadforms/n8n-nodes-leadforms
n8n community nodes for LeadForms: send leads from your
quizzes, Leadforms Pages and website widgets to any n8n workflow the moment they arrive.
Installation
Self-hosted n8n: Settings → Community nodes → Install, enter @leadforms/n8n-nodes-leadforms, confirm.
See the n8n guide to installing community nodes.
Manual install (queue mode, Docker images without the GUI installer):
cd ~/.n8n/nodes
npm install @leadforms/n8n-nodes-leadforms
# restart n8n
Credentials
The nodes authenticate with a LeadForms API key.
- Sign in to your LeadForms dashboard and open AI agents and API:
cp.leadforms.org/app/mcp (leadforms.org accounts) or
cp.leadforms.ru/app/mcp (leadforms.ru accounts). - Create a key with the purpose Zapier / Make / n8n. It starts with
lfk_, is shown once and can only
read leads and manage lead subscriptions. - In n8n create LeadForms API credentials: choose your account (leadforms.org or leadforms.ru) and paste
the key. n8n checks it againstGET /v1/me.
Revoking the key in LeadForms also removes the subscriptions created with it.
Nodes
| Node | What it does |
|---|---|
| LeadForms Trigger | Instant trigger. When the workflow is activated it subscribes to new leads (all quizzes, pages and widgets, or the ones you pick); when deactivated it unsubscribes. Every delivery is signed (X-Leadforms-Signature, HMAC-SHA256 with a per-subscription secret) and the node rejects requests with a wrong or missing signature. |
| LeadForms | Get Many: leads that arrived after a given lead ID (cursor, oldest first). Get Latest: most recent leads. Get Sample: the latest lead, or an example of the same shape if there are none yet. Can be used as a tool by n8n AI agents. |
Your n8n webhook URL must be reachable from the internet: LeadForms does not deliver to private or local
addresses. Leads are delivered within seconds; failed deliveries are retried for about 14 hours.
Lead fields
Each item is the lead as LeadForms sends it (id, quizId, created, created_at, contacts, answers,extra, result, quizDurationSeconds, version) plus flat fields for easy mapping:
| Field | Example |
|---|---|
name, phone, email, comment |
John Smith, +15551234567, client@example.com |
answers_text |
Which service are you interested in?: Consultation (one line per question) |
answers_by_question |
{"Which service are you interested in?": "Consultation"} |
page_url |
https://example.com/ |
utm_source, utm_medium, utm_campaign |
google, cpc, spring_sale |
created_at |
2026-10-21T09:00:00Z (ISO 8601, UTC) |
Example workflows
New lead → Google Sheets row
- LeadForms Trigger: pick the LeadForms API credentials; leave Quiz, Page or Widget empty for all leads.
- Google Sheets → Append Row in Sheet: map columns, for example
Date={{ $json.created_at }},Name={{ $json.name }},Phone={{ $json.phone }},Email={{ $json.email }},Answers={{ $json.answers_text }},Source={{ $json.utm_source }}. - Activate the workflow and submit a test lead on your quiz.
New lead → Slack or Telegram message
LeadForms Trigger (optionally limited to one quiz).
Slack → Send Message (or Telegram → Send Message) with text:
New lead from {{ $json.page_url }} {{ $json.name }} {{ $json.phone }} {{ $json.email }} {{ $json.answers_text }}
Catch up on missed leads on a schedule
- Schedule Trigger every 15 minutes.
- LeadForms → Get Many with After Lead ID = the ID of the last lead you processed
(store it with workflow static data or in a sheet;0means from the very first lead). - Process the items and save the
idof the last one for the next run.
Compatibility
Built against n8n-workflow 2.x, n8nNodesApiVersion 1 (n8n 1.x and newer). No runtime dependencies.
Resources
- LeadForms · LeadForms (Russia)
- n8n community nodes documentation
- Support: info@leadforms.org, issues:
GitHub
Development
npm install
npm run lint # @n8n/node-cli lint (n8n community node rules)
npm test # n8n-node build + node --test
Releases are published from GitHub Actions with npm provenance (.github/workflows/publish.yml) when av* tag matching package.json is pushed. The source of truth lives in the LeadForms monorepo
(integrations/n8n); this repository is its public mirror.