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-leadveyor in ~/.n8n/nodes, then restart n8n.

Credentials

  1. In the Leadveyor console, open API keys and create a key with permission Write.
  2. 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

ResourceOperationWhat it does
MessageSendSends 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.
ScoreScore TextScores text or form fields right away and returns score, tier, summary and the full result. Nothing is saved.
LeadGetOne lead by ID.
LeadGet ManyRecent leads, with filters by tier, minimum score and outcome.
LeadRecord OutcomeWon, 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.

Was this page helpful?