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.
| Need | How the agent helps | System used |
|---|---|---|
| Narrate a script | Generates audio from text with an AI voice | ElevenLabs |
| Record a short announcement | Turns a written message into an audio file | ElevenLabs |
| Review your voice agents | Looks at and manages the voice agents in your account | ElevenLabs |
| Deliver the result | Saves the audio as a file you can share | Artifacts |
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.
- Open the Connectors screen in DoubleX Agentes.
- Find ElevenLabs in the list of connectors (it is in the design category).
- Start the connection and follow the authorization steps for your ElevenLabs account.
- Choose the scope of the connection: personal, team, or company (more on this below).
- Open the Agents screen, select the agent that should produce audio, and turn on the ElevenLabs connector for it.
- 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.
| Scope | Who can use it | Good for |
|---|---|---|
| Personal | Only you | Testing and your own voice projects |
| Team | Members of the team | A marketing or training team producing audio together |
| Company | The whole company | A 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
- How to Connect Box to an AI Agent: Step-by-Step GuideLearn how to connect Box to an AI agent: set up the connector, limit it to read-only, choose who can use it, and check the history of your first request.
- How to Connect Jam to an AI Agent: Step-by-Step GuideLearn how to connect Jam bug reports to an AI agent in DoubleX Agentes: set up the connector, pick who can use it, limit permissions, and run a first test.