/n ![ElevenAgents phone numbers page](file:assets/images/conversational-ai/phone-numbers-page.png)\n </Frame>\n\n Next, fill in the following details:\n\n * **Label:** A descriptive name (e.g., `Customer Support Line`).\n * **Phone Number:** The Twilio number you want to use.\n * **Twilio SID:** Your Twilio Account SID or API Key SID.\n * **Twilio Token:** Your Twilio Auth Token or API Key Secret.\n\n <Tip>\n **Recommended: Use API keys for better security.** Instead of using your account-wide credentials, you can [create a Twilio API key](https://www.twilio.com/docs/iam/api-keys) with limited permissions. When you create an API key, Twilio provides a **SID** (starts with `SK`) and a **Secret** — use these in the fields above.\n </Tip>\n\n <Note>\n You can find your account SID and auth token [**in the Twilio admin console**](https://www.twilio.com/console), or create API keys in the [API keys section](https://www.twilio.com/console/project/api-keys).\n </Note>\n\n <Tabs>\n <Tab title=\"ElevenAgents dashboard\">\n <Frame background=https://elevenlabs.io/"subtle/">/n ![Phone number configuration](file:assets/images/conversational-ai/phone-numbers-new.png)\n </Frame>\n </Tab>\n\n <Tab title=\"Twilio admin console\">\n Copy the Twilio SID and Auth Token from the [Twilio admin\n console](https://www.twilio.com/console).\n\n <Frame background=https://elevenlabs.io/"subtle/">/n ![Phone number details](file:assets/images/conversational-ai/twilio-settings.png)\n </Frame>\n </Tab>\n </Tabs>\n\n <Note>\n ElevenLabs automatically configures the Twilio phone number with the correct settings.\n </Note>\n\n <Accordion title=\"Applied settings\">\n <Frame background=https://elevenlabs.io/"subtle/">/n ![Twilio phone number configuration](file:assets/images/conversational-ai/twilio-configuration.png)\n </Frame>\n </Accordion>\n\n <Info>\n **Phone Number Detection**: ElevenLabs will automatically detect whether your number supports:\n\n * **Inbound + Outbound**: Numbers purchased through Twilio\n * **Outbound Only**: Numbers verified as caller IDs in Twilio\n\n If your number is not found in either category, you'll receive an error asking you to verify it exists in your Twilio account.\n </Info>\n </Step>\n\n <Step title=\"Assign your agent (Inbound-capable numbers only)\">\n If your phone number supports inbound calls, you can assign an agent to handle incoming calls.\n\n <Frame background=https://elevenlabs.io/"subtle/">/n ![Select agent for inbound calls](file:assets/images/conversational-ai/twilio-assigned-agent.png)\n </Frame>\n\n <Note>\n Numbers that only support outbound calls (verified caller IDs) cannot be assigned to agents and\n will show as disabled in the agent dropdown.\n </Note>\n </Step>\n</Steps>\n\nTest the agent by giving the phone number a call. Your agent is now ready to handle inbound calls and engage with your customers.\n\n<Tip>\n Monitor your first few calls in the [Calls History\n dashboard](https://elevenlabs.io/app/agents/history) to ensure everything is working as expected.\n</Tip>\n\n## Making Outbound Calls\n\n<Info>\n Both purchased Twilio numbers and verified caller IDs can be used for outbound calls. The outbound\n call button will be disabled for numbers that don't support outbound calling.\n</Info>\n\nYour imported Twilio phone number can also be used to initiate outbound calls where your agent calls a specified phone number.\n\n<Steps>\n <Step title=\"Initiate an outbound call\">\n From the [**Phone Numbers**](https://elevenlabs.io/app/agents/phone-numbers) tab, locate your imported Twilio number and click the **Outbound call** button.\n\n <Frame background=https://elevenlabs.io/"subtle/">/n ![Outbound call button](file:assets/images/conversational-ai/outbound-button.png)\n </Frame>\n </Step>\n\n <Step title=\"Configure the call\">\n In the Outbound Call modal:\n\n 1. Select the agent that will handle the conversation\n 2. Enter the phone number you want to call\n 3. Click **Send Test Call** to initiate the call\n\n <Frame background=https://elevenlabs.io/"subtle/">/n ![Outbound call configuration](file:assets/images/conversational-ai/outbound-modal.png)\n </Frame>\n </Step>\n</Steps>\n\nOnce initiated, the recipient will receive a call from your Twilio number. When they answer, your agent will begin the conversation.\n\n<Tip>\n Outbound calls appear in your [Calls History dashboard](https://elevenlabs.io/app/agents/history)\n alongside inbound calls, allowing you to review all conversations.\n</Tip>\n\n<Note>\n When making outbound calls, your agent will be the initiator of the conversation, so ensure your\n agent has appropriate initial messages configured to start the conversation effectively.\n</Note>\n"],"perViewerCopy":[0,true],"askAiEnabled":[0,false],"skillsConfig":[0],"availability":[0],"pageActions":[0,{"options":[0,{"copyPage":[0,true],"viewAsMarkdown":[0,true],"askAi":[0,true],"openAi":[0,true],"claude":[0,true],"cursor":[0,true],"claudeCode":[0,true],"vscode":[0,false],"custom":[1,[[0,{"title":[0,"LLMs full"],"subtitle":[0,"See the entire documentation site as markdown for LLMs"],"url":[0,"https://elevenlabs.io/docs/llms-full.txt"],"icon":[0,"fa-solid fa-file-code"]}]]]}]}],"pageActionsStyle":[0,"default"],"pageActionFiles":[0],"showRssFeedButton":[0,false],"showPageActions":[0,true]}" ssr client="deferred" opts="{"name":"PageHeaderIsland","value":true}" await-children>

Twilio native integration

Learn how to configure inbound calls for your agent with Twilio.

Overview

This guide shows you how to connect a Twilio phone number to your ElevenLabs agent to handle both inbound and outbound calls.

You will learn to:

Import an existing Twilio phone number.
Link it to your agent to handle inbound calls.
Initiate outbound calls using your agent.

Phone Number Types & Capabilities

ElevenLabs supports two types of Twilio phone numbers with different capabilities:

Purchased Twilio Numbers (Full Support)

Inbound calls: Supported - Can receive calls and route them to agents
Outbound calls: Supported - Can make calls using agents
Requirements: Number must be purchased through Twilio and appear in your “Phone Numbers” section

Verified Caller IDs (Outbound Only)

Inbound calls: Not supported - Cannot receive calls or be assigned to agents
Outbound calls: Supported - Can make calls using agents
Requirements: Number must be verified in Twilio’s “Verified Caller IDs” section
Use case: Ideal for using your existing business number for outbound AI calls

Learn more about verifying caller IDs at scale in Twilio’s documentation.

During phone number import, ElevenLabs automatically detects the capabilities of your number based on its configuration in Twilio.

Guide

Prerequisites

A Twilio account.
Either:
- A purchased & provisioned Twilio phone number (for inbound + outbound)
- OR a verified caller ID in Twilio (for outbound only)

Import a Twilio phone number

In the ElevenAgents dashboard, go to the Phone Numbers tab.

Next, fill in the following details:

Label: A descriptive name (e.g., Customer Support Line).
Phone Number: The Twilio number you want to use.
Twilio SID: Your Twilio Account SID or API Key SID.
Twilio Token: Your Twilio Auth Token or API Key Secret.

Recommended: Use API keys for better security. Instead of using your account-wide credentials, you can create a Twilio API key with limited permissions. When you create an API key, Twilio provides a SID (starts with SK) and a Secret — use these in the fields above.

You can find your account SID and auth token in the Twilio admin console, or create API keys in the API keys section.

ElevenAgents dashboard

Twilio admin console

ElevenLabs automatically configures the Twilio phone number with the correct settings.

Applied settings

Phone Number Detection: ElevenLabs will automatically detect whether your number supports:

Inbound + Outbound: Numbers purchased through Twilio
Outbound Only: Numbers verified as caller IDs in Twilio

If your number is not found in either category, you’ll receive an error asking you to verify it exists in your Twilio account.

Assign your agent (Inbound-capable numbers only)

If your phone number supports inbound calls, you can assign an agent to handle incoming calls.

Numbers that only support outbound calls (verified caller IDs) cannot be assigned to agents and will show as disabled in the agent dropdown.

Test the agent by giving the phone number a call. Your agent is now ready to handle inbound calls and engage with your customers.

Monitor your first few calls in the Calls History dashboard to ensure everything is working as expected.

Making Outbound Calls

Both purchased Twilio numbers and verified caller IDs can be used for outbound calls. The outbound call button will be disabled for numbers that don’t support outbound calling.

Your imported Twilio phone number can also be used to initiate outbound calls where your agent calls a specified phone number.

Initiate an outbound call

From the Phone Numbers tab, locate your imported Twilio number and click the Outbound call button.

Configure the call

In the Outbound Call modal:

Select the agent that will handle the conversation
Enter the phone number you want to call
Click Send Test Call to initiate the call

Once initiated, the recipient will receive a call from your Twilio number. When they answer, your agent will begin the conversation.

Outbound calls appear in your Calls History dashboard alongside inbound calls, allowing you to review all conversations.

When making outbound calls, your agent will be the initiator of the conversation, so ensure your agent has appropriate initial messages configured to start the conversation effectively.