Package Information
Available Nodes
Documentation generating…
Documentation
n8n-nodes-leadpoet
This is an n8n community node for Leadpoet. Leadpoet
turns an ideal customer profile (ICP) into researched, qualified companies and
contacts, then moves them through a sales pipeline. This node lets n8n
workflows and n8n AI agents read that pipeline and make safe updates to it.
n8n is a fair-code licensed
workflow automation platform.
Installation ·
Credentials ·
Operations ·
Usage ·
Compatibility ·
Resources
Installation
Follow the community nodes installation guide.
In n8n, open Settings → Community Nodes → Install and entern8n-nodes-leadpoet.
Credentials
The node uses a Leadpoet API key.
- In Leadpoet, open Settings → Developer → API keys. The workspace owner
and team admins can create keys. Every plan, Free included, has API access. - Create a key and choose only the permissions your workflow needs:
pipeline:readfor Company, Contact, Deal and Signal readspipeline:writefor Company Update, Add Note, Add Task, Find Email or
LinkedIn, Deal Create and Signal Marklead_engine:readfor ICP and Lead Request readsoutreach:readfor Campaign readscredits:readfor Account → Get Credits
- Copy the secret. Leadpoet shows it once.
- In n8n, create a Leadpoet API credential and paste the key. n8n checks
it withGET /api/v1/me, which costs nothing and changes nothing.
You can revoke a key in Leadpoet at any time.
Operations
| Resource | Operation | What it does |
|---|---|---|
| Account | Get Credits | Credit balance and plan allocation |
| Campaign | Get | One campaign's settings, status and contact counts |
| Campaign | Get Analytics | Rolling 90-day email and LinkedIn summary |
| Campaign | Get Many | Campaigns with status and contact, message and reply counts |
| Company | Add Note | Note on a company, or on one of its contacts or deals |
| Company | Get | One pipeline company's full details and contacts |
| Company | Get Many | Pipeline companies, filterable by name, domain and stage |
| Company | Get Research | Researched facts with source, evidence link, confidence and freshness |
| Company | Update | Stage, pin, notes, owner, deal value, currency, close date, sales motion |
| Contact | Add Task | Follow-up reminder on a contact (sends nothing) |
| Contact | Find Email or LinkedIn | Fills a missing work email or LinkedIn profile; 1 credit, refunded when nothing is found |
| Contact | Get Many | Contacts on an ICP's contact pipeline |
| Deal | Create | Manual deal on a pipeline company |
| Deal | Get Many | Active or archived deals with open and won totals |
| ICP | Get | One ICP with its published version and draft |
| ICP | Get Many | The workspace's active ICPs |
| Lead Request | Get | One lead request's status and delivered counts |
| Lead Request | Get Many | Lead requests, newest first |
| Signal | Get Many | Buying-intent alerts (funding, new jobs, leadership news and more), grouped by account |
| Signal | Mark | Mark alerts reviewed, dismissed or new |
What this node does not do
It never sends outreach, launches or resumes campaigns, or approves drafts for
sending. Those actions need the outreach:send permission and stay in the
Leadpoet app, where a person reviews them. The node also does not start paid
lead requests or watch accounts for signals, which reserve credits.
Usage
- Get Many operations return one n8n item per company, contact, campaign,
ICP, lead request or signal group. For companies, contacts and campaigns,
turn on Return All to follow Leadpoet's pages, or set Limit. Lead
requests use Limit and Page. - Create operations send an
Idempotency-Key. By default it is unique to the
item, the execution and the node's settings, so n8n's Retry On Fail never
creates a duplicate. Set your own key under Options to control this. - IDs chain between operations. For example: ICP → Get Many gives an ICP ID for
Contact → Get Many, and Company → Get Many gives the company card ID for
Company → Add Note and Deal → Create. - AI agents: the node is usable as a tool, so an n8n AI Agent can call any
operation above. Give the agent a key with only the permissions it needs.
To use Leadpoet from Claude, ChatGPT, Cursor and other assistants without
n8n, see Leadpoet in AI assistants.
Compatibility
Built with @n8n/node-cli 0.55. Tested on n8n 2.46 against a mocked Leadpoet
API.