curl -X POST 'https://api.elevenlabs.io/v1/convai/phone-numbers' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "phone_number": "string",
  "label": "string",
  "supports_inbound": true,
  "supports_outbound": true,
  "provider": "twilio",
  "agent_id": "string",
  "sid": "string",
  "token": "string",
  "region_config": {
    "region_id": "us1",
    "token": "string",
    "edge_location": "ashburn"
  },
  "enable_sms": true
}'

# POST /v1/convai/phone-numbers (ElevenLabs API)
Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-09-03

> Import Phone Number

## Critical Gotchas
* Authentication uses the non-standard `xi-api-key` header, not `Authorization: Bearer`. Sending a Bearer token returns HTTP 401.
* Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (`--output speech.mp3`) rather than parsing it.

## cURL
curl -X POST 'https://api.elevenlabs.io/v1/convai/phone-numbers' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"phone_number":"string","label":"string"}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| phone_number | body | string | Yes | Phone number |
| label | body | string | Yes | Label for the phone number |
| sid | body | string | Yes | Twilio Account SID |
| token | body | string | Yes | Twilio Auth Token |

## Response (200 OK)
{"phone_number_id":"string"}

---
Need an API key? Get one at https://elevenlabs.io/app/sign-up

POST

/v1/convai/phone-numbers

ElevenLabs API

Import Phone Number

Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-09-03 · upstream hash matched

Actions

Agents: curl -H "Accept: text/markdown" this URL
→ 218 tokens · Vary: Accept

Critical gotchas

Authentication uses the non-standard xi-api-key header, not Authorization: Bearer. Sending a Bearer token returns HTTP 401.

Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (--output speech.mp3) rather than parsing it.

cURL

curl -X POST 'https://api.elevenlabs.io/v1/convai/phone-numbers' \  -H "xi-api-key: $ELEVENLABS_API_KEY" \  -H 'Content-Type: application/json' \  -d '{  "phone_number": "string",  "label": "string",  "supports_inbound": true,  "supports_outbound": true,  "provider": "twilio",  "agent_id": "string",  "sid": "string",  "token": "string",  "region_config": {    "region_id": "us1",    "token": "string",    "edge_location": "ashburn"  },  "enable_sms": true}'

Get a free ElevenLabs API key → sponsored

Parameters

Name	In	Type	Required	Description
phone_number	body	string	Yes	Phone number
label	body	string	Yes	Label for the phone number
supports_inbound	body	boolean	No	This field is deprecated and will be removed in the future. Whether this phone number supports inbound calls
supports_outbound	body	boolean	No	This field is deprecated and will be removed in the future. Whether this phone number supports outbound calls
provider	body	string	No	Request body field provider.
agent_id	body	string	No	Agent ID to assign the phone number to
sid	body	string	Yes	Twilio Account SID
token	body	string	Yes	Twilio Auth Token
region_config	body	object	No	Twilio Additional Region Configuration
enable_sms	body	boolean	No	Route inbound SMS to ElevenLabs. On by default; set to false to skip SMS configuration for numbers that don't support it.

Response 200 OK

{
  "phone_number_id": "string"
}