How to Connect ElevenLabs to an AI Agent: Step-by-Step Guide

· DoubleX

Quick answer

To connect ElevenLabs to an AI agent, open the Connectors screen in DoubleX Agentes, choose ElevenLabs, authorize your account, and pick who can use the connection. Then ask the agent for a short audio clip as a test. The agent can generate audio and manage your account's voice agents.

ElevenLabs is a platform for generating speech with AI voices and building voice agents. Once it is connected to an AI agent, you can ask for narration or audio in plain language instead of opening another tool. This guide covers the connection path and a first test, without getting into advanced routines.

What can the ElevenLabs connector do?#

The ElevenLabs connector lets an agent generate audio with AI voices and manage the voice agents in your ElevenLabs account. The agent uses these tools while it works on a request, so you can ask for audio the same way you would ask a colleague.

NeedHow the agent helpsSystem used
Narrate a scriptGenerates audio from text with an AI voiceElevenLabs
Record a short announcementTurns a written message into an audio fileElevenLabs
Review your voice agentsLooks at and manages the voice agents in your accountElevenLabs
Deliver the resultSaves the audio as a file you can shareArtifacts

For ideas on how to use voice in your daily work, see the related guide on ElevenLabs with an AI agent: voice audio and voice agents.

What do you need before connecting?#

You need an active ElevenLabs account and a clear idea of who will use the connection. The connector works with the account you authorize, so use the account that holds the voices and voice agents you want the agent to reach.

Before you start, check these points:

  • You can sign in to the ElevenLabs account you want to use.
  • You have a DoubleX Agentes account. Creating one is free and needs no credit card.
  • You know whether the connection is only for you, for a team, or for the whole company.
  • You have at least one agent ready. If not, the diagnostic can build a team of agents for you. See the Quickstart.

How do you connect ElevenLabs on the Connectors screen?#

You connect ElevenLabs from the Connectors screen by choosing it from the list and authorizing your account. Then you allow the agent to use it.

  1. Open the Connectors screen in DoubleX Agentes.
  2. Find ElevenLabs in the list of connectors (it is in the design category).
  3. Start the connection and follow the authorization steps for your ElevenLabs account.
  4. Choose the scope of the connection: personal, team, or company (more on this below).
  5. Open the Agents screen, select the agent that should produce audio, and turn on the ElevenLabs connector for it.
  6. Review the actions the agent is allowed to run in ElevenLabs and save.

Credentials for connections are stored encrypted with AES-256-GCM. If you want to manage connectors through code, the Connectors API documentation explains how.

Personal, team, or company connection: which should you choose?#

Choose personal if the ElevenLabs account belongs to you, team if a group shares it, and company if everyone should use the same account. A personal connection only works for you, while team and company connections are available to more people.

ScopeWho can use itGood for
PersonalOnly youTesting and your own voice projects
TeamMembers of the teamA marketing or training team producing audio together
CompanyThe whole companyA shared brand voice account

Roles of owner, administrator, and member control who can manage connections. When in doubt, begin with a personal connection to test, then move to a team or company connection once the setup works.

How do you test with a first request?#

Test with a short, low-risk request, such as a few sentences turned into audio. If the agent returns a file you can play, the connection works.

Try one of these requests:

  • "Generate an audio clip of this welcome message in a friendly voice: 'Hi, welcome to our team. Your first week starts on Monday.'"
  • "Turn the intro paragraph of our product update into a 30-second audio narration."
  • "List the voice agents in my ElevenLabs account."
  • "Create an audio version of this announcement and give me the file."

If the agent cannot reach ElevenLabs, return to the Connectors screen and check that the connection is active and that the connector is enabled for that agent.

How do you control what the agent can do and review the history?#

For each agent you choose which systems it uses and which actions it can run in each one. Actions that change data can stay off, so the agent only reads. Before sending, deleting, or changing something in your systems, the agent asks for confirmation and shows the steps it took.

Every request becomes a task on the Tasks screen, with the full history: the request, each tool the agent used, and the result. You can see who asked, what was done, and when. Content from your company is not used to train models, and requests only go to AI providers that do not use what they receive for training. On the Models screen you can also choose zero retention, which uses only providers that store nothing after responding.

To learn more about how the pieces fit together, read the Introduction. If you want to compare another connection process, see how to connect Box to an AI agent.

Frequently asked questions#

Do I need to code to connect ElevenLabs?#

No. You connect it from the Connectors screen and describe what you need in your own words. A REST API, CLI, and MCP server exist for those who want to go further.

Can the agent create audio and manage voice agents?#

Yes. The ElevenLabs connector lets the agent generate audio with AI voices and manage the voice agents in your account. You decide which actions each agent is allowed to run.

Can I connect ElevenLabs only for myself?#

Yes. A personal connection only works for you. You can choose a team or company connection when others need to use it.

Where do I see what the agent did with ElevenLabs?#

On the Tasks screen. Each request keeps a history with the request, the tools used, and the result.

What if I run out of credits?#

Usage stops when your company reaches its credit limit, so there are no surprise charges. You can buy extra credits if you need more.

Related guides

More ElevenLabs guides