n8n
Leadveyor has two nodes for n8n: Leadveyor Trigger starts a workflow when a lead is scored, and Leadveyor sends messages, scores text, gets leads and records outcomes.
Install
The nodes are an n8n community package, n8n-nodes-leadveyor.
- n8n Cloud and self-hosted with the UI: Settings → Community Nodes → Install, enter
n8n-nodes-leadveyor. - Self-hosted with Docker or npm:
npm install n8n-nodes-leadveyorin~/.n8n/nodes, then restart n8n.
Credentials
- In the Leadveyor console, open API keys and create a key with permission Write.
- In n8n, create a Leadveyor API credential and paste the key. Leave API URL as it is.
With an account-wide key, choose the Workspace in each node; with a workspace key, leave it on the key's own workspace.
Leadveyor Trigger
Starts the workflow when something happens in the workspace:
- Events — Lead Scored (default), Lead Created, Lead Updated, Outcome Recorded, Message Was Junk, Message Failed, Usage Threshold Reached.
- Only These Tiers — for example
hot, warm; empty means every lead. - Simplify — on: the lead with name, email, phone, summary, score, tier, reasons and consoleUrl on top and the complete lead under
lead. Off: the raw event.
Activating the workflow creates a webhook named "n8n: workflow name"; deactivating removes it. Every request is checked against the webhook's signing secret, so nobody else can start the workflow.
Leadveyor only sends to public https:// addresses. A self-hosted n8n must be reachable from the internet with HTTPS (set WEBHOOK_URL in n8n); localhost won't receive events.
Leadveyor node
| Resource | Operation | What it does |
|---|---|---|
| Message | Send | Sends an enquiry — text, form fields or both — to be filtered and scored. Optional: sender, subject, channel, your own External ID (a repeat with the same ID isn't processed twice) and metadata. |
| Score | Score Text | Scores text or form fields right away and returns score, tier, summary and the full result. Nothing is saved. |
| Lead | Get | One lead by ID. |
| Lead | Get Many | Recent leads, with filters by tier, minimum score and outcome. |
| Lead | Record Outcome | Won, lost, no response, disqualified or other, with deal value and reason. |
The node can also be used as a tool by n8n's AI Agent.
Example
Hot leads to Slack, the rest to a sheet: Leadveyor Trigger (Lead Scored) → IF {{ $json.tier }} is hot → Slack Send message {{ $json.name }}: {{ $json.summary }} {{ $json.consoleUrl }}; otherwise → Google Sheets Append row.