n8n-nodes-vocallabs
The official n8n community node for VocalLabs — integrate AI-powered voice calling, agent management, and call analytics directly into your n8n workflows.
Website | API Docs | GitHub | Support
Installation
Community Nodes (Recommended)
- Open your n8n instance
- Go to Settings > Community Nodes
- Click Install a community node
- Enter
n8n-nodes-vocallabs
- Click Install
Manual Install
npm install n8n-nodes-vocallabs
Important: Whitelist your server's IP before using the node.
Follow the guide at docs.vocallabs.ai/ip-whitelist.
Getting Started
1. Get Your API Credentials
- Log in to your VocalLabs Dashboard
- Navigate to Settings > API Keys
- Copy your Client ID and Client Secret
2. Configure in n8n
- Add the VocalLabs node to your workflow
- Click Create New Credential
- Enter your Client ID and Client Secret
- Click Test to verify your credentials are valid
- Save — authentication is handled automatically
3. Build Your Workflow
Select a resource, pick an operation, fill in the parameters, and execute.
Available Resources & Operations
Dashboard
| Operation |
Description |
| Get Dashboard Stats |
Retrieve usage metrics and overview |
| Get Tokens |
List available API tokens |
Call
| Operation |
Description |
| Initiate Call |
Start a new AI voice call |
| Create Direct Call |
Call via client token |
| Get Call Details |
Retrieve call information |
| Get Voices |
List available voice options |
| Get Call API Tokens |
Retrieve call tokens |
| Call API (Webhook) |
Initiate call via webhook |
| Get Call Timeline |
Call history with pagination |
| Get Daily Calls |
Daily call statistics |
| Get WebSocket URL |
Real-time call connection |
| Get Audit |
Retrieve single call audit |
| Get All Audits |
List all call audits |
| Upload Audio |
Upload audio files to agent |
Agent
| Operation |
Description |
| Get Agents |
List all AI agents |
| Get Agent By ID |
Retrieve agent details |
| Create Agent |
Create a new AI agent |
| Update Agent |
Modify agent configuration |
| Get Agent Templates |
Available agent templates |
| Get Voices By Language |
Language-specific voices |
| Toggle Favorite |
Mark/unmark agent as favorite |
| Update Agent Shared |
Set agent visibility |
| Agent Prompt History |
View prompt change history |
| Update Success Metric |
Configure success metrics |
| Update WhatsApp Notification |
Toggle WhatsApp alerts |
| Update Mail Notification |
Toggle email alerts |
| Get Agent Documents |
List agent documents |
| Insert Agent Document |
Upload document to agent |
| Get AI Models |
Available AI models |
| Get Agent Actions |
List agent actions |
| Update Agent Reschedule |
Configure rescheduling |
| Get Keyword Replacements |
List keyword rules |
| Get Agent Keywords |
List agent keywords |
| Add Keyword |
Create keyword replacement |
| Update Keyword |
Modify keyword replacement |
| Delete Keyword |
Remove keyword replacement |
| Get Template |
Get agent template details |
| Get Agent Samples |
Template sample data |
| Get Agent FAQs |
List agent FAQ entries |
| Manage Agent FAQ |
Create, update, or delete FAQ |
Analytics
| Operation |
Description |
| Get Call Statuses |
Available call status types |
| Get Call Conversation |
Call transcript |
| Get Call Data |
Detailed call analytics |
| Get Call Status |
Current call status |
| Get Call Summary |
Call summary and notes |
| Get Post-Call Data |
Post-call metadata |
| Update Post-Call Data |
Modify post-call metadata |
| Delete Post-Call Data |
Remove post-call data |
| Get VocalLabs Call |
Full call details |
Contact
| Operation |
Description |
| Create Contact Group |
Create a new group |
| Create Contact In Group |
Add contact to group |
| Update Contact Metadata |
Modify contact metadata |
| Get Contact Groups |
List all groups |
| Update Contact Group |
Rename a group |
| Delete Contact Group |
Remove a group |
| Delete Contact |
Remove a contact |
| Get Contacts |
List contacts with pagination |
| Add Multiple Contacts |
Bulk import contacts |
| Get Contact Data |
Retrieve contact details |
| Update Contact Data |
Modify contact data |
| Get Contact |
Get single contact |
| Create Contact Group V2 |
Create group (v2 API) |
| Add Multiple Contacts V2 |
Bulk import (v2 API) |
Campaign
| Operation |
Description |
| Get Campaigns |
List all campaigns |
| Create Campaign |
Create a new campaign |
| Update Campaign |
Modify campaign details |
| Delete Campaign |
Remove a campaign |
| Get Queueing Details |
Campaign queue status |
| Get Campaign Status |
Current campaign status |
| Update Campaign Status |
Activate/deactivate campaign |
| Add Contacts to Campaign |
Assign contacts to campaign |
Library
| Operation |
Description |
| Get Actions |
List all actions |
| Create Action |
Create a new action |
| Update Action |
Modify an action |
| Delete Action |
Remove an action |
| Get Documents |
List all documents |
| Delete Document |
Remove a document |
| Get Action Templates |
Available templates |
| Get Action Template Details |
Template details |
| Get Action Parameters |
Action parameter config |
| Get Action Fields |
Action field definitions |
| Get Action Configuration |
Full action config |
Identity
| Operation |
Description |
| Get Flows |
List verification flows |
| Get Identity URL |
Generate KYC/verification URL |
SIP
| Operation |
Description |
| Create SIP Call |
Initiate a SIP call |
Wallet
| Operation |
Description |
| Get Balance |
Check account balance |
| Get Transaction History |
View transaction records |
Marketplace
| Operation |
Description |
| Fetch Available Numbers |
Browse purchasable numbers |
| Get Numbers |
List your phone numbers |
| Fetch Countries |
Available countries |
Key Features
- 100+ Operations — Full coverage of the VocalLabs API across 11 resources
- Secure Authentication — Uses n8n's built-in
httpRequestWithAuthentication with automatic token management via preAuthentication. Tokens are never exposed in workflow output data
- Concurrent Request Safety — Mutex-based token refresh ensures only one
createAuthToken call happens even when 50+ workflows trigger simultaneously, protecting your daily token limit
- Multi-Credential Support — Use different VocalLabs accounts in the same workflow without conflicts
- Clean Error Handling — API errors are parsed into readable messages with proper error codes
- Input Validation — Phone numbers, dates, JSON fields, and pagination are validated before sending to the API
- Bulk Operations — Import contacts and manage campaigns in batch
Workflow Examples
Initiate an AI Call
[Manual Trigger] -> [VocalLabs: Initiate Call]
- Resource: Call
- Operation: Initiate Call
- Agent ID:
your-agent-id
- Prospect ID:
your-prospect-id
Bulk Import Contacts and Launch Campaign
[Spreadsheet] -> [VocalLabs: Create Contact Group] -> [VocalLabs: Add Multiple Contacts] -> [VocalLabs: Create Campaign] -> [VocalLabs: Add Contacts to Campaign]
Monitor Call Analytics
[Schedule Trigger] -> [VocalLabs: Get Daily Calls] -> [VocalLabs: Get Call Summary] -> [Slack: Send Message]
Troubleshooting
| Issue |
Solution |
| Authentication failed |
Verify your Client ID and Client Secret in the credential settings |
| Rate limit exceeded |
The API allows 10 requests/minute. Add delays between nodes or use n8n's batch processing |
| IP not whitelisted |
Whitelist your server's IP at docs.vocallabs.ai/ip-whitelist |
| Node not appearing |
Restart n8n after installation. Check with npm list n8n-nodes-vocallabs |
| 502 Bad Gateway |
Usually indicates an expired token — the node auto-refreshes and retries. If persistent, check API status |
Resources
Support
Changelog
v2.4.0
- Migrated to n8n's
httpRequestWithAuthentication with preAuthentication and authenticate on credential class — resolves n8n verification requirements
- Removed Auth resource that exposed raw bearer tokens in workflow output data
- Added mutex-based
preAuthentication to prevent concurrent token creation (protects daily token limit)
- Added node codex file (
Vocallabs.node.json) for proper n8n node browser categorization
- Added credential icon
- Changed
inputs/outputs to use NodeConnectionTypes.Main instead of string literals
- Renamed resource
Contacts to Contact (singular, per n8n conventions)
- Removed
.npmignore ("files": ["dist"] in package.json handles publishing scope)
v2.3.3
- Added credential test — users can now verify their Client ID and Client Secret directly from the n8n credential setup screen
v2.3.2
- Overhauled auth token management with Promise mutex — concurrent requests share a single token, preventing "max auth tokens" errors
- Fixed first-run crash where token was undefined
- Fixed retry logic to use fresh token headers after refresh
- Added multi-credential support per workflow
- Improved error handling for Cloudflare 502 responses
- Detects both 401 and 502 as auth errors for automatic token refresh
v2.2.0
- Enhanced error handling across all operations
- Improved setup documentation
v2.0.0
- 100+ API operations across 12 resources
- Secure token management and caching
v1.0.0
License
MIT License - see LICENSE for details.
Built by VocalLabs | GitHub | hello@vocallabs.ai
