Skip to content
Book a demoStart free trial
Start free trialBook a demo
Docs

Connect ElevenLabs

You build and run your client’s agents on ElevenAgents, the ElevenLabs agent platform. Voice AI Portal connects to that ElevenLabs account with an API key, then shows your client their conversations, recordings, transcripts and results under your brand.

Before you begin

Section titled “Before you begin”
  • Access to the client’s ElevenLabs account, ideally one account or workspace per client.
  • At least one agent built on ElevenAgents. Phone numbers are optional but recommended.

Create the API key in ElevenLabs

Section titled “Create the API key in ElevenLabs”

ElevenLabs has two kinds of key. Either works with Voice AI Portal.

  • A personal API key belongs to the person who creates it. Create one from your ElevenLabs profile settings, under API keys.
  • A service account key belongs to the workspace rather than a person, so it keeps working if team members change. Workspace admins on multi-seat plans create these under Workspace settings, Service Accounts. This is the better choice for a client you will look after for a long time.

  1. Sign in to ElevenLabs with the client’s account and open the API keys page for the kind of key you chose.

  2. Create a new key and give it a name you will recognise later, for example Voice AI Portal, Acme Dental.

  3. Set the key’s access. If you restrict the key’s scope, give it write access to the agents platform (ElevenAgents). The portal reads agents, phone numbers and conversations, and uses write access to delete a call when you ask it to and to place outbound campaign calls.

  4. For a personal key, leave Expire After set to Never, or note the expiry date. An expired key stops the client’s portal from loading new data until you replace it.

  5. Copy the key.

Connect the key in Voice AI Portal

Section titled “Connect the key in Voice AI Portal”

  1. Go to Clients and select Add client.

  2. Enter the Client name and choose ElevenLabs as the provider.

  3. Paste the key into API key and select Validate API Key and Load Assets.

  4. Finish the Add client wizard: choose the agents and numbers for this client, then the regional, staff-time value and outbound settings. See Create a client workspace.

How the portal checks the key

Section titled “How the portal checks the key”

When you validate, the portal uses the key to list the agents and phone numbers in the ElevenLabs account.

  • If ElevenLabs accepts the key, you see Connected and how many agents and numbers were found.
  • If ElevenLabs rejects the key, you see an error. Check that you copied the whole key, that it has not expired or been disabled, and that its scope includes the agents platform.

After that, the portal reads conversations from ElevenLabs each time a page in the client’s portal loads, so your client sees their latest conversations without any export or sync on your side.

Outbound campaigns on ElevenLabs

Section titled “Outbound campaigns on ElevenLabs”

Outbound campaigns for an ElevenLabs client place calls through a Twilio phone number connected to the client’s ElevenLabs account. Connect the number in ElevenLabs first, then select it for the client in Agents & numbers in Client settings (or on the Assets step when you add the client). See Configure outbound calling.

Next steps

Section titled “Next steps”