n8n-nodes-vapi

This is an n8n community node for VAPI — the developer platform for building voice AI agents.

Create and manage voice assistants, make outbound phone calls, handle inbound call webhooks, and automate your entire voice AI pipeline directly from n8n.

n8n is a fair-code licensed workflow automation platform.

Table of Contents

• Installation
• Credentials
• Nodes
  • VAPI Node
  • VAPI Trigger Node
• Operations Reference
  • Assistant
  • Call
  • Phone Number
  • Squad
• Usage Examples
  • Example 1 — Outbound Call
  • Example 2 — Create Assistant
  • Example 3 — End of Call Report
  • Example 4 — Function Calling
• Compatibility
• Resources
• License

Installation

Community Nodes (Recommended)

1. Open your n8n instance
2. Go to Settings > Community Nodes
3. Select Install
4. Enter n8n-nodes-vapi in the input field
5. Agree to the risks and click Install

Manual Installation

# Navigate to your n8n user directory (usually ~/.n8n)
cd ~/.n8n

# Install the package
npm install n8n-nodes-vapi

# Restart n8n

Docker

If you're running n8n with Docker, add this to your Dockerfile:

RUN cd /usr/local/lib/node_modules/n8n && npm install n8n-nodes-vapi

Or mount as a volume with a custom package.json that includes the dependency.

Credentials

You need a VAPI API Key to use this node.

How to get your API Key

1. Go to dashboard.vapi.ai
2. Navigate to Organization Settings (or your profile)
3. Copy your API Key (Private Key)

Configure in n8n

1. In any VAPI node, click on Credentials > Create New
2. Enter your API Key
3. Click Save
4. The credential will automatically be tested by listing your assistants

Nodes

This package includes two nodes:

VAPI Node

The main node for interacting with the VAPI API. Supports full CRUD operations on assistants, calls, phone numbers, and squads.

| Resource | Available Operations | |---|---| | Assistant | Create, Get, Get Many, Update, Delete | | Call | Create Outbound, Create Web Call, Get, Get Many, Delete | | Phone Number | Get, Get Many, Delete | | Squad | Get, Get Many, Delete |

VAPI Trigger Node

A webhook trigger node that receives events from VAPI's Server URL. Use this to react to call events in real-time.

| Event Filter | Description | |---|---| | All Events | Triggers on any webhook event | | Assistant Request | VAPI needs assistant configuration dynamically | | End of Call Report | A call has ended — includes transcript, cost, duration | | Function Call | The assistant is calling a custom function | | Hang | A hang event was detected during the call | | Speech Update | Speech status changed (started/stopped speaking) | | Status Update | Call status changed (ringing, in-progress, ended) | | Tool Calls | The assistant invoked one or more tools | | Transcript | Real-time transcript update | | Transfer Destination Request | A call transfer was requested |

Operations Reference

Assistant

Create

Creates a new voice assistant.

| Parameter | Type | Required | Description | |---|---|---|---| | Name | string | Yes | Name of the assistant | | First Message | string | No | What the assistant says when the call starts | | System Prompt | string | No | Instructions for the assistant LLM | | LLM Provider | select | No | OpenAI, Anthropic, Google, Custom LLM | | LLM Model | select | No | gpt-4o, gpt-4o-mini, claude-3.5-sonnet, etc. | | TTS Provider | select | No | ElevenLabs, Azure, Deepgram, OpenAI, etc. | | Voice ID | string | No | Voice ID from the TTS provider | | Max Duration (s) | number | No | Maximum call duration in seconds | | Silence Timeout (s) | number | No | Silence threshold before ending the call | | End Call Message | string | No | Message to say before ending | | Server URL | string | No | Webhook URL for this assistant's events |

Get

Retrieves a single assistant by its ID.

| Parameter | Type | Required | Description | |---|---|---|---| | Assistant ID | string | Yes | The unique ID of the assistant |

Get Many

Lists all assistants in your account.

| Parameter | Type | Required | Description | |---|---|---|---| | Limit | number | No | Max results to return (default: 50, max: 100) |

Update

Updates an existing assistant.

| Parameter | Type | Required | Description | |---|---|---|---| | Assistant ID | string | Yes | The unique ID of the assistant | | Name | string | No | New name | | First Message | string | No | New first message | | System Prompt | string | No | New system prompt | | Server URL | string | No | New webhook URL |

Delete

Deletes an assistant by ID.

Call

Create (Outbound)

Creates an outbound phone call using a VAPI phone number.

| Parameter | Type | Required | Description | |---|---|---|---| | Phone Number ID | string | Yes | Your VAPI phone number ID | | Customer Phone Number | string | Yes | Target number in E.164 format (e.g. +5511999999999) | | Assistant Configuration | select | Yes | "Use Existing Assistant" or "Inline (Transient)" | | Assistant ID | string | Conditional | Required if using existing assistant | | First Message | string | Conditional | Required if using inline assistant | | System Prompt | string | Conditional | Required if using inline assistant | | Customer Name | string | No | Name of the customer (context) | | Max Duration (s) | number | No | Max call duration | | Server URL | string | No | Webhook URL for this call | | Squad ID | string | No | Use a squad instead of single assistant | | Metadata (JSON) | json | No | Custom metadata for the call | | Assistant Overrides (JSON) | json | No | Override assistant settings for this call |

Create (Web)

Creates a web-based call (browser-to-browser or browser-to-phone).

Same parameters as Outbound but without Phone Number ID and Customer Phone Number.

Get

Retrieves a call by ID. Returns full details including transcript, cost breakdown, messages, duration, and status.

Get Many

Lists calls with optional filters.

| Parameter | Type | Required | Description | |---|---|---|---| | Limit | number | No | Max results (default: 50) | | Assistant ID | string | No | Filter by assistant | | Phone Number ID | string | No | Filter by phone number |

Delete

Deletes a call record by ID.

Phone Number

Get

Retrieves a phone number by ID.

Get Many

Lists all phone numbers in your account.

| Parameter | Type | Required | Description | |---|---|---|---| | Limit | number | No | Max results (default: 50) |

Delete

Deletes a phone number by ID.

Squad

Get

Retrieves a squad by ID.

Get Many

Lists all squads in your account.

Delete

Deletes a squad by ID.

Usage Examples

Example 1 — Outbound Call from a Webhook

Trigger a phone call when an external event occurs (e.g. form submission, CRM update).

[Webhook] → [VAPI: Call > Create Outbound]

1. Add a Webhook node as the trigger
2. Add a VAPI node with:
   • Resource: Call
   • Operation: Create (Outbound)
   • Phone Number ID: your VAPI phone number
   • Customer Phone Number: {{ $json.phone }}
   • Assistant Configuration: Use Existing Assistant
   • Assistant ID: your assistant ID

Example 2 — Create an Assistant with Custom Prompt

Dynamically create assistants based on data from another system.

[Trigger] → [VAPI: Assistant > Create]

1. Add any trigger node
2. Add a VAPI node with:
   • Resource: Assistant
   • Operation: Create
   • Name: {{ $json.agentName }}
   • System Prompt: {{ $json.instructions }}
   • First Message: Hello! How can I help you today?

Example 3 — Receive End of Call Reports

Process call reports after each call ends (e.g., save to database, send notification).

[VAPI Trigger: End of Call Report] → [IF: call.cost > 0.5] → [Slack: Send Message]

1. Add a VAPI Trigger node
   • Event Filter: End of Call Report
2. Copy the webhook URL from the node
3. Set this URL as the Server URL in your VAPI assistant or call configuration
4. Connect downstream nodes to process the report data

The trigger receives data including:

• message.call — full call object with status, duration, cost
• message.transcript — complete conversation transcript
• message.summary — AI-generated summary of the call
• message.recordingUrl — URL of the call recording

Example 4 — Handle Function Calls from the Assistant

Let your voice assistant trigger n8n workflows (e.g., look up order status, book appointments).

[VAPI Trigger: Function Call] → [Switch: functionName] → [HTTP Request: CRM API] → [Respond to Webhook]

1. Add a VAPI Trigger node
   • Event Filter: Function Call
2. Use a Switch node to route based on {{ $json.message.functionCall.name }}
3. Process the function (query database, call API, etc.)
4. Use Respond to Webhook to return the result back to VAPI

Compatibility

| Requirement | Version | |---|---| | n8n | >= 0.200.0 | | Node.js | >= 18.0.0 |

Tested with n8n versions 1.x.

Resources

• VAPI Documentation
• VAPI Dashboard
• VAPI API Reference
• n8n Community Nodes Documentation

License

MIT