Vapi

Vapi

This connector works with one Vapi organization through the Vapi REST API (https://api.vapi.ai): voice assistants and squads, phone calls (list, inspect transcripts, recordings, analysis and costs, start outbound calls), phone numbers and who answers them, the tools assistants call, uploaded files and knowledge bases, text chats with assistants, outbound campaigns and call analytics.

Setup (2 minutes)

1. Sign in at https://dashboard.vapi.ai and open API Keys (organization settings).
2. Copy the private key (not the public key, which only starts web calls) into VAPI_API_KEY. It is sent as Authorization: Bearer <key> and has the full rights of the organization.
3. Run vapi_list_assistants to check the key.

Calls cost money and reach real people: vapi_create_call dials a real phone number. Vapi bills every minute (platform, model, voice, transcriber and telephony), and calling people who did not agree to it can break telemarketing laws (TCPA in the US, and similar rules elsewhere). Show the user the number called, the number called from, the assistant and the variables, and start the call only after a clear yes. vapi_create_chat also bills model usage. Changes made with vapi_update_assistant and vapi_update_phone_number affect live calls at once; confirm them too.

Workflow

• Assistants: vapi_list_assistants, then vapi_get_assistant for the prompt (model.messages), voice and settings. Create one with vapi_create_assistant, change it with vapi_update_assistant (read it first: model, voice and other objects are replaced as a whole). Squads: vapi_list_squads, vapi_get_squad.
• Testing a prompt without a phone: vapi_create_chat with the assistant id and a message; keep the conversation going with previous_chat_id. Past chats: vapi_list_chats, vapi_get_chat.
• Call history: vapi_list_calls (filter by assistant, number or time), then vapi_get_call for the transcript, the summary in analysis, the recording URL and the cost breakdown. When a call failed without an obvious endedReason, vapi_get_call_logs gives the debug log.
• Outbound calls: pick a number with vapi_list_phone_numbers and an assistant, then vapi_create_call with customer_number (E.164) and template variables in assistant_overrides.variableValues. Poll vapi_get_call until status is ended. Campaigns (batch calls set up in the dashboard): vapi_list_campaigns, vapi_get_campaign.
• Inbound routing: vapi_get_phone_number, vapi_update_phone_number to set the assistant or squad that answers.
• Tools: vapi_list_tools, vapi_get_tool.
• Knowledge: vapi_list_files, vapi_get_file, vapi_upload_file (from a public URL), vapi_list_knowledge_bases, vapi_get_knowledge_base.
• Reporting: vapi_query_analytics for counts, minutes and spend per day, assistant or ended reason.

Reading the answers: ids are UUIDs. Times are ISO 8601 in UTC. cost and the costBreakdown are in USD. Call status runs scheduled, queued, ringing, in-progress, forwarding, ended; endedReason says why it ended (customer-ended-call, assistant-ended-call, silence-timed-out, voicemail, or an error code such as pipeline-error-...). Recording URLs in artifact are links to Vapi storage.

Paging: the list tools for assistants, calls, squads, tools and files return a plain array, newest first, capped by limit. For the next page pass the createdAt of the last item as created_at_lt. Phone numbers, chats and campaigns return results with metadata (currentPage, totalPages, hasNextPage); pass page.

Errors: 401 means a wrong key or the public key; 400 names the field Vapi rejected (for example a number not in E.164 format, or both assistant_id and squad_id); 404 an unknown id; 402 or a billing error means the organization has no credit left; 429 a rate or concurrency limit (concurrent calls are capped per plan).