Skip to main content
Voice AI Pods and Provider Connections

Connect Vapi

Connect your Vapi organization as a Pod: where to find the organization ID and API keys, when to use the EU domain, and how to fix connection errors.

Written By voiceaiwrapper

Last updated 26 days ago

Connect your Vapi organization to VoiceAIWrapper so you can run campaigns, give clients access and track calls for the assistants you've built in Vapi. You add Vapi as a Pod (an engine or provider connection) by pasting four values from your Vapi dashboard. It takes about 5 minutes.

Available on: plans that include Vapi. Without it, the VAPI card shows Not in your plan and can't be selected. On some plans, each provider connection also uses one BYOK connection add-on. When they're all in use, clicking Next opens an upgrade prompt instead of the credentials form.

Applies to: BYOK Pods on Vapi. Your built-in VAW Native Pod needs no keys. See What Is a Voice AI Pod?

Before you start

You'll need:

  • A Vapi account with the organization you want to connect, and access to its settings and API keys.
  • To know your Vapi region. If you sign in at dashboard.eu.vapi.ai, your organization is in the EU region.
  • Your Vapi concurrency limit: how many calls your Vapi organization can run at once.
  • A Vapi organization that isn't connected anywhere else in VoiceAIWrapper. Each Vapi organization can be connected to only one Pod, across all VoiceAIWrapper organizations.

Step 1: Choose Vapi

  1. In the header, click the Pod selector, then click Add Pod. On a phone, the Pod selector is at the top of the sidebar menu. The Connect Your VoiceAI Pod drawer opens on Choose Provider.
  2. Select VAPI ("Connect your VAPI account").
  3. Click Next.
The Connect Your VoiceAI Pod drawer on its first step (Choose Provider highlighted in the stepper), showing the heading Choose your VoiceAI Provider, the VAPI, Retell AI and ElevenLabs cards with VAPI selected, the Tip box at the bottom and the Next button.

Step 2: Enter your Vapi credentials

The Configure VAPI step asks for six values. Two buttons above the fields open the right Vapi pages in a new tab: Find VAPI Org settings and Find VAPI API keys. They open the standard dashboard, so if your organization is in the EU region, open dashboard.eu.vapi.ai yourself.

FieldWhere to find it in VapiNotes
Vapi Organization NameProfile button β†’ Settings β†’ Org Settings β†’ Organization NameBecomes the Pod's name in VoiceAIWrapper.
Vapi Organization IDSame page β†’ Organization ID
Vapi Private KeyVapi API Keys (under BUILD in the Vapi sidebar) β†’ Private KeyUsed to check the connection and manage your assistants.
Vapi Public KeySame page β†’ Public Key
Vapi Concurrency LimitYour Vapi plan's concurrencyStarts at 10. "Please make sure this value is same as in your Vapi.ai org."
Use EU DomainYour sign-in addressTurn on if your organization uses dashboard.eu.vapi.ai.

The organization ID and both keys are long codes in the format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Copy them exactly.

The Configure VAPI step (Add Credentials highlighted) filled in: Vapi Organization Name, Vapi Organization ID, Vapi Private Key and Vapi Public Key (keys masked), Vapi Concurrency Limit set to a number, the Use EU Domain switch off, and the Find VAPI Org settings and Find VAPI API keys buttons above the fields. Blur the organization ID.

Not sure where a value is? Click Show me how in the Need help finding these values? box. A step-by-step slideshow shows each screen in Vapi.

The same step with the blue Need help finding these values? box expanded after clicking Show me how, showing the first slide of the Vapi help carousel (Settings under the profile button).

When everything is filled in, click Next. VoiceAIWrapper checks that the organization isn't already connected and that the private key works by reading your assistants. If both pass, you'll see "VoiceAI pod credential created successfully" and move to the last step.

Step 3: Split your concurrency

The Set Concurrency step shows your Total (the Vapi Concurrency Limit you entered) and how it's divided between Outbound and Inbound calls. It starts split evenly, with any odd line going to outbound.

  1. Change Outbound or Inbound. The other one adjusts so they always add up to the total.
  2. Click Complete Setup.

You'll see "Concurrency distribution updated successfully". To learn how the split affects campaigns, see Split Concurrency Between Inbound and Outbound Calls.

After you connect

Troubleshooting

The value isn't in the expected format. Vapi IDs and keys look like xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Check that you copied the whole value, with no extra spaces or characters, and that you didn't paste the organization name or another field by mistake.

VoiceAIWrapper couldn't read your assistants with that key. Check that:

  • You copied the Private Key, not the Public Key, into Vapi Private Key.
  • The key belongs to the organization whose ID you entered and hasn't been deleted in Vapi.
  • Use EU Domain matches your region. An EU organization needs it on; other organizations need it off.

This Vapi organization, or one of its keys, is already connected to a Pod. That Pod can be in this organization or in another VoiceAIWrapper organization, including one you own. Use the existing Pod, or delete it first and then connect again. Deleting a Pod also deletes its campaigns, calls and analytics, so read Manage Pods: Rename, Update Keys, Switch and Delete before you do.

Your plan doesn't include Vapi, or every BYOK connection on your plan is already used by another Pod. The upgrade prompt shows how to unlock it, for example by adding a BYOK connection or moving to a plan that includes Vapi. Only an organization owner or admin can upgrade. See Add-Ons: BYOK Connections, Client Accounts and Team Members.

Open the Pod selector and click the pencil (or Edit) for the Vapi Pod. The Update VoiceAI Pod drawer opens on Update Credentials. Change the keys or Vapi Concurrency Limit, click Next, check the split on Set Concurrency, then click Update Concurrency.

More connection errors are covered in Errors When Connecting a Provider.