Skip to main content
Voice AI Pods and Provider Connections

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:

  1. In the Retell sidebar, click Settings (under SYSTEM).
  2. Click API Keys.
  3. 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

  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 Retell AI ("Connect your Retell account").
  3. Click Next.

Step 2: Enter your Retell credentials

The Configure Retell AI step has two fields:

FieldWhat to enter
Retell Organization NameA name for this Pod, such as your Retell workspace or client name. It's how the Pod appears in the Pod selector.
Retell API KeyThe key you copied from Retell.

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.

The Connect Your VoiceAI Pod drawer on the Configure Retell AI step (Add Credentials highlighted in the stepper), with the Find Retell API keys button, Retell Organization Name filled in, Retell API Key filled in and masked, the collapsed Need help finding these values? box and the Next button.

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.

  1. Change Outbound or Inbound. The other one adjusts so they always add up to the total.
  2. 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.

  1. Open the VoiceAI Pods page. It isn't in the sidebar. Open your Account Dashboard, add /providers to 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.
  2. On your Retell AI Pod's card, find Concurrency and click Refresh next to it. Hovering over it shows Sync concurrency from provider.
  3. You'll see "Concurrency synced successfully", and Total shows the new limit.
The VoiceAI Pods page with a Retell AI Pod card: the Concurrency row with the small Refresh button and its tooltip Sync concurrency from provider showing on hover, the Total value, and the Outbound and Inbound numbers under the slider. Blur the Pod ID.

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

Troubleshooting

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.

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.

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.

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.