Skip to main content
Troubleshooting and FAQs

Errors When Connecting a Provider

Fix the errors you can see when you connect Vapi, Retell AI or ElevenLabs as a Pod: invalid or duplicate keys, EU accounts, webhook URLs, plan limits and concurrency.

Written By voiceaiwrapper

Last updated 26 days ago

When you connect your own Vapi, Retell AI or ElevenLabs account as a Pod (an engine or provider connection), VoiceAIWrapper checks your details with the provider before it saves anything. If a check fails, you see an error and the Pod isn't created. This article lists each error, what causes it and how to fix it, starting with the most common.

Where errors appear

  • In the Connect Your VoiceAI Pod drawer (header Pod selector β†’ Add Pod), the error appears as a pop-up message after you click Next on Add Credentials. The same happens in the Update VoiceAI Pod drawer when you change a Pod's keys.
  • In the onboarding wizard, it appears in a red box titled Could not save your connection, above the form.
  • Format errors appear in red under a field while you type, before anything is sent to the provider.

Your built-in VAW Native Pod needs no keys, so none of these errors apply to it.

Find your error

ErrorProviderMost likely cause
Invalid Private KeyVapiWrong key, or Use EU Domain set wrongly
Invalid Retell API KeyRetell AIWrong, deleted or public key
Invalid ElevenLabs API KeyElevenLabsWrong, disabled or restricted key
Organization Id, Public Key or Private Key already existsVapiAccount already connected to a Pod
Retell API Key already in use / ElevenLabs API Key already in useRetell AI, ElevenLabsKey already connected to a Pod
ElevenLabs Webhook URL is not correctElevenLabsWebhook in ElevenLabs points to another address
Not in your plan, or an upgrade promptAllPlan doesn't include the provider, or all BYOK connections are used

Key and account errors

VoiceAIWrapper tries to read your assistants with the Vapi Private Key, and Vapi refused. Check that:

  • You pasted the Private Key into Vapi Private Key, not the Public Key.
  • The key belongs to the organization whose Vapi Organization ID you entered, and it hasn't been deleted in Vapi.
  • Use EU Domain matches your Vapi region. See the next question.

See Connect Vapi for where each value lives in Vapi.

If you sign in to Vapi at dashboard.eu.vapi.ai, your organization is in the EU region. Turn on Use EU Domain ("Enable if your VAPI organization uses the EU region (dashboard.eu.vapi.ai)") on the Configure VAPI step, then click Next again. With the switch off, VoiceAIWrapper checks your key against the standard region and you get Invalid Private Key.

The reverse is also true: leave Use EU Domain off for organizations that aren't in the EU region.

The Find VAPI Org settings and Find VAPI API keys buttons open the standard Vapi dashboard. For an EU organization, open dashboard.eu.vapi.ai yourself to copy the values.

This is a format check, not a check with Vapi. Vapi organization IDs and keys look like xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Copy the whole value again, with no spaces or extra characters, and make sure you didn't paste a name or another field by mistake.

VoiceAIWrapper uses the key to read your concurrency limit from Retell AI, and Retell refused it. Check that:

  • You copied a key from the API Keys tab in Retell's settings, not the Public Keys tab.
  • You copied the whole key, with no spaces.
  • The key still exists in Retell. If in doubt, create a new key in Retell and try again.

See Connect Retell AI.

VoiceAIWrapper uses the key to read your ElevenLabs plan, list your webhooks and update your agents. The form says "Please ensure that you enter an unrestricted API key." A key created with Restrict Key turned on usually fails these checks, either with Invalid ElevenLabs API Key or with another message from ElevenLabs.

To fix it, create a new key in ElevenLabs (Developers β†’ API Keys) with Restrict Key left off, paste it into ElevenLabs API Key and click Next. See Connect ElevenLabs Agents.

Each provider account can be connected to only one Pod across all of VoiceAIWrapper. The account or key you entered is already connected, either in this organization or in another VoiceAIWrapper organization, including one you own.

ProviderWhat's checked
VapiThe organization ID, the private key and the public key
Retell AIThe API key
ElevenLabsThe API key

What to do:

  • If the Pod is in this organization, use it. Open the Pod selector in the header to find it.
  • If you want to move the account to another VoiceAIWrapper organization, delete the Pod in the old organization first, then connect it in the new one.

Deleting a Pod permanently deletes its campaigns, phone number pools, calls, analytics, client configurations and any Stripe products linked to it in VoiceAIWrapper. It can't be undone. Read Manage Pods: Rename, Update Keys, Switch and Delete first.

ElevenLabs webhook errors

VoiceAIWrapper found the webhook with your ElevenLabs Webhook ID, but it points to a different address than the Webhook Callback URL shown at the bottom of the form.

  1. On the Configure ElevenLabs step, click Copy next to Webhook Callback URL.
  2. In ElevenLabs, open Developers β†’ Webhooks and add a new endpoint with that exact URL.
  3. Copy the new endpoint's secret and ID.
  4. Paste them into ElevenLabs Webhook Secret and ElevenLabs Webhook ID, then click Next.

Adding a new endpoint is usually quicker than editing the old one, because ElevenLabs shows the secret only once.

VoiceAIWrapper can only check the webhook's URL when it finds the ElevenLabs Webhook ID you entered in your workspace. A mistyped ID isn't caught when you connect. Check the ID in ElevenLabs (Developers β†’ Webhooks). If it's wrong, open the Pod selector and choose Edit for the Pod (the pencil icon on the Pod you're in, or the Pod's menu for other Pods). Correct ElevenLabs Webhook ID on Update Credentials and click Next.

Then sync webhooks on each agent so its call results reach VoiceAIWrapper. See Sync Webhooks So VoiceAIWrapper Can Track Calls.

Plan and BYOK connection errors

Your plan doesn't include that provider. On Choose Provider, its card shows Not in your plan and can't be selected. If the check happens when you click Next, an upgrade prompt opens instead, titled Unlock followed by the provider's name.

The prompt shows which plan or add-on unlocks the provider. Only an organization owner or admin can upgrade; other team members see "Ask your organization owner or admin to upgrade." See A Feature Is Locked or Asks Me to Upgrade.

On some plans, each Vapi, Retell AI or ElevenLabs Pod uses one BYOK connection add-on. When they're all in use, picking a provider and clicking Next opens an upgrade prompt instead of the credentials form. It says "Add a provider connection (BYOK) to keep going" and shows Used on your plan with how many you have.

You can:

  • Click Add provider connection (BYOK). This adds a paid add-on, and you see the amount in Billing before you confirm.
  • Upgrade to a plan that includes provider connections, if the prompt offers one.
  • Delete a Pod you no longer use. Its connection becomes free for a new Pod right away.

See Add-Ons: BYOK Connections, Client Accounts and Team Members.

A BYOK connection add-on was removed, for example after a failed payment. VoiceAIWrapper then disables your newest provider Pods until you're back within the number you pay for. Their active campaigns are paused, scheduled campaigns go back to draft, and you can't start them.

Add the BYOK connection again from Settings β†’ Billing. The Pod is re-enabled, but its campaigns stay paused until you start them again. See Failed Payments.

Concurrency doesn't match your provider

Your provider has its own limit on calls at once. If the Pod's Total in VoiceAIWrapper is higher than your provider's limit, the provider rejects the extra calls. Where the total comes from depends on the provider:

ProviderWhere the total comes fromHow to fix a mismatch
VapiThe Vapi Concurrency Limit you typed ("Please make sure this value is same as in your Vapi.ai org.")Open the Pod selector, choose Edit for the Pod, change Vapi Concurrency Limit, click Next, then Update Concurrency.
Retell AIRead from your Retell AI account when you connectOn the Pod's card on the VoiceAI Pods page, click Refresh next to Concurrency ("Sync concurrency from provider").
ElevenLabsYour ElevenLabs plan when you connectSet once, when you connect. Updating the keys doesn't change it.

After a Retell AI refresh changes the total, the split between inbound and outbound goes back to even. Check it afterwards. See Split Concurrency Between Inbound and Outbound Calls.

VoiceAIWrapper couldn't reach Retell AI with the saved key, usually because the key was deleted or replaced in Retell. Open the Pod selector, choose Edit for the Pod, paste a working Retell API Key on Update Credentials, click Next, then Update Concurrency. Then click Refresh again.

Other messages

The connection failed for a reason the webapp couldn't name, often a short outage at the provider. Wait a minute and click Next again. If it keeps happening, contact support.

Still stuck? Open Need help? β†’ Help Chat. Tell us which provider you're connecting and the exact error, but never paste your API keys into the chat.