Connect Retell AI
Connect your Retell AI account as a Pod with one API key. VoiceAIWrapper reads your Retell concurrency for you, and you can refresh it when your Retell limit changes.
Written By voiceaiwrapper
Last updated 26 days ago
Connect your Retell AI account to VoiceAIWrapper to run campaigns, give clients access and track calls for the agents you've built in Retell. You add Retell as a Pod (an engine or provider connection) with a name and one API key. VoiceAIWrapper reads your concurrency limit from Retell, so there's nothing to type for it. It takes about 3 minutes.
Available on: plans that include Retell. Without it, the Retell AI 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 Retell AI. Your built-in VAW Native Pod needs no keys. See What Is a Voice AI Pod?
Before you start
You'll need:
- A Retell AI account you can sign in to.
- A Retell API key that isn't connected anywhere else in VoiceAIWrapper. Each Retell key can be connected to only one Pod, across all VoiceAIWrapper organizations.
To get a key in Retell:
- In the Retell sidebar, click Settings (under SYSTEM).
- Click API Keys.
- On the API Keys tab, copy an existing key, or click Add Key to create a new one.
Use a key from the API Keys tab, not the Public Keys tab.
Step 1: Choose Retell AI
- 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.
- Select Retell AI ("Connect your Retell account").
- Click Next.
Step 2: Enter your Retell credentials
The Configure Retell AI step has two fields:
The Find Retell API keys button opens the Retell API keys page in a new tab. If you need a walkthrough, click Show me how in the Need help finding these values? box.

Click Next. VoiceAIWrapper checks that the key isn't already connected, then asks Retell for your account's concurrency limit. That check also proves the key works. You'll see "VoiceAI pod credential created successfully".
Step 3: Split your concurrency
The Set Concurrency step shows the Total that VoiceAIWrapper read from Retell. It starts split evenly between Outbound and Inbound, with any odd line going to outbound.
- Change Outbound or Inbound. The other one adjusts so they always add up to the total.
- Click Complete Setup.
See Split Concurrency Between Inbound and Outbound Calls for how the split affects your campaigns.
When your Retell limit changes
If you buy more concurrency in Retell, or your limit goes down, refresh it in VoiceAIWrapper. Updating the Pod's keys doesn't change the total.
- Open the VoiceAI Pods page. It isn't in the sidebar. Open your Account Dashboard, add
/providersto the end of the address in your browser's address bar, and press Enter. The address then ends in your organization ID followed by/providers. - On your Retell AI Pod's card, find Concurrency and click Refresh next to it. Hovering over it shows Sync concurrency from provider.
- You'll see "Concurrency synced successfully", and Total shows the new limit.

If the total changed, the split goes back to even. To rebalance it, drag the slider on the card, or open the Pod selector, click the pencil (or Edit) for the Pod and go through to Set Concurrency.
After you connect
- Your agents appear automatically. Open Agents (voice) or Chat Agents in the Pod. Any agent you create in Retell later shows up there too.
- Sync webhooks before you use an agent or number. See Sync Webhooks So VoiceAIWrapper Can Track Calls.
- Phone numbers come from Retell. See Phone Numbers on Vapi, Retell, ElevenLabs and Bolna.
Troubleshooting
I get "Invalid Retell API Key".
I get "Invalid Retell API Key".
Retell didn't accept the key. Check that you copied the whole key from the API Keys tab (not a public key), with no extra spaces, and that the key hasn't been deleted in Retell. If in doubt, create a new key with Add Key and try again.
I get "Retell API Key already in use".
I get "Retell API Key already in use".
This key is already connected to a Pod, in this organization or another VoiceAIWrapper organization. Use the existing Pod, or delete it first. Deleting a Pod also deletes its campaigns, calls and analytics, so read Manage Pods: Rename, Update Keys, Switch and Delete first.
Refresh shows "Failed to get concurrency".
Refresh shows "Failed to get concurrency".
VoiceAIWrapper couldn't reach Retell with the saved key, usually because the key was deleted or replaced in Retell. Update the key: open the Pod selector, click the pencil (or Edit) for the Pod, paste the new Retell API Key, click Next, then Update Concurrency. Then refresh again.
I see an upgrade prompt or "Not in your plan".
I see an upgrade prompt or "Not in your plan".
Your plan doesn't include Retell, or every BYOK connection on your plan is already in use. The upgrade prompt shows how to unlock it, for example by adding a BYOK connection or moving to a plan that includes Retell. Only an organization owner or admin can upgrade. See Add-Ons: BYOK Connections, Client Accounts and Team Members.
More connection errors are covered in Errors When Connecting a Provider.
Related articles
Was this helpful?
More in Voice AI Pods and Provider Connections
What Is a Voice AI Pod?Bolna and Ultravox Pods (Legacy)Split Concurrency Between Inbound and Outbound CallsSync Webhooks So VoiceAIWrapper Can Track CallsStill need help? Share an idea