Package Information
Available Nodes
Documentation generatingβ¦
Documentation
n8n-nodes-leadaudio
Official n8n community node package for LeadAudio AI β the autonomous B2B voice synthesis and outbound engagement platform.
Automate personalized voice message outreach directly within your self-hosted or cloud n8n workflows. Connect any CRM (HubSpot, Salesforce, Pipedrive), Google Sheets, Airtable, or incoming webhooks to instantly synthesize custom AI voice notes in your own voice clone and deliver interactive landing links (/v/[slug]).
β‘ Key Capabilities
- Outbound Voice Ingestion: Ingest single prospects or bulk batches into the autonomous synthesis queue with custom vocal tones (
friendly,urgent,empathetic) and dynamic pain points. - Dynamic Cloned Voice Selection: Synthesize voice notes using any of your trained neural voice profiles, or fall back automatically to your active default voice model.
- Asynchronous State & Asset Polling: Query real-time synthesis status (
pending,completed,failed), fetch personalized interactive landing pages (https://getleadaudio.com/v/[slug]), and retrieve direct.mp3audio files stored in high-speed cloud storage. - Enterprise-Grade Defensive Error Handling: Descriptive in-canvas error reporting for credit exhaustion, invalid keys, or subscription tier boundaries.
π¦ Installation
Option 1: Via n8n Community Nodes UI (Recommended)
- In your n8n workspace, navigate to Settings > Community Nodes.
- Click Install a community node.
- Enter
n8n-nodes-leadaudioand click Install. - The LeadAudio AI node is now immediately available in your workflow canvas under the Communication / Sales & CRM categories.
Option 2: Via npm in Self-Hosted / Docker
Run inside your n8n root or custom extensions folder:
npm install n8n-nodes-leadaudio
For Docker instances, add n8n-nodes-leadaudio to the NODE_FUNCTION_ALLOW_EXTERNAL environment variable or bake it into your custom Dockerfile.
π Authentication Setup
- Log in to your LeadAudio AI Dashboard.
- Go to Settings > API Keys (
/dashboard/settings/api-keys). - Click Create API Key, enter a description (e.g.
n8n Production), and copy your key (la_live_...). - In n8n, create a new credential of type LeadAudio AI API:
- Base URL:
https://getleadaudio.com(leave as default for Cloud SaaS). - API Key: Paste your
la_live_...key.
- Base URL:
- Save the credential. n8n will automatically verify connectivity via
/api/v1/auth/verify.
π‘ Note: Programmatic API access requires an active Agency Tier subscription on LeadAudio AI.
π Operations & Usage
1. Operation: "Trigger Campaign"
Dispatch prospect leads into LeadAudio's asynchronous queue.
Configuration:
- Campaign Name (Optional): Descriptive label (e.g.,
HubSpot High-Intent MQLs). - Voice ID (Optional): Dropdown selector populated dynamically from your cloned voices, or left blank to use your default voice.
- Lead Ingestion Mode:
Single Lead (From Current Item): MapProspect Name,Company Name,Vocal Tone, andContext Notesdirectly from preceding node output.Multiple Leads (Explicit Collection): Build a structured list of leads in the node UI.Raw Leads Array (JSON): Pass an array of objects[{"name": "...", "company": "...", "tone": "...", "notes": "..."}].
Output Example:
{
"success": true,
"campaign_id": "8da2aabb-f566-46f4-90f4-ec280a2ee221",
"queued_leads": 1,
"message": "Campaign successfully accepted and queued for autonomous voice synthesis."
}
2. Operation: "Get Voice-Link Status"
Monitor synthesis progress, retrieve interactive landing page links, and get direct MP3 audio URLs.
Configuration:
- Identifier: Lead UUID, voice-link slug (
sarah-connor-a232gi), or Campaign UUID.
Output Example (Lead Record):
{
"success": true,
"type": "lead",
"id": "e0c9ae56-9596-4d07-9d76-bc8664b56be2",
"lead_name": "Sarah Connor",
"lead_company": "Cyberdyne Systems",
"tone": "urgent",
"status": "completed",
"voice_link_slug": "sarah-connor-a232gi",
"voice_link_url": "https://getleadaudio.com/v/sarah-connor-a232gi",
"audio_url": "https://yqehxgqcqjnzkoyfzzug.supabase.co/storage/v1/object/public/voice-audios/user/camp/sarah-connor-a232gi.mp3?v=1730000000",
"generated_script": "Hey Sarah, it's Alex! Quick heads upβI noticed inbound lead response delay is directly impacting pipeline growth this quarter. We deployed an autonomous voice engine that recovers up to 24% of lost deals... talk soon!",
"error_message": null,
"campaign_id": "8da2aabb-f566-46f4-90f4-ec280a2ee221",
"created_at": "2026-10-27T21:00:00.000Z",
"updated_at": "2026-10-27T21:01:15.000Z"
}
π Example Workflow: Inbound Lead to Personalized Voice DM
[ Typeform / Webhook Trigger ]
β
βΌ
[ LeadAudio AI: Trigger Campaign ]
β (captures campaign_id & slug)
βΌ
[ Wait: 30 Seconds ]
β
βΌ
[ LeadAudio AI: Get Voice-Link Status ]
β
βΌ
[ Slack / SendGrid / LinkedIn Automation ]
(Sends: "Hey Sarah! Recorded a quick 30s voice memo for you here: {{ $json.voice_link_url }}")
π‘ Robustness & Error Handling
| HTTP Code | Error Reason | Node Behavior |
|---|---|---|
401 Unauthorized |
Invalid or revoked API key | Halts execution with clear instruction to verify API key. |
402 Payment Required |
Credit balance exhausted | Alerts user that account credits are 0, with direct billing link. |
403 Forbidden |
Tier access boundary | Informs user that Agency plan is required for programmatic access. |
404 Not Found |
Unknown lead/campaign ID | Displays clear message that resource does not exist. |
π License
MIT Β© 2026 LeadAudio AI