Skip to main content
POST
Import phone number

Headers

x-api-key
string | null

Your API key for programmatic access. Send it in the x-api-key header; you can create and manage keys from the Developers page.

Body

application/json

Create Phone Request Information

phone_number
string
required

Phone number

label
string
required

Label for the phone number

sid
string
required

Twilio Account SID (starts with AC) or API Key SID (starts with SK)

token
string
required

Secret paired with sid: the Account Auth Token for an Account SID, or the API Key Secret for an API Key SID

provider
string
default:twilio
Allowed value: "twilio"
agent_id
string | null

Agent ID to assign the phone number to

account_auth_token
string | null

Twilio Account Auth Token, required for API Key imports to validate inbound webhook signatures

region_config
RegionConfigRequest · object | null

Twilio Additional Region Configuration

enable_sms
boolean
default:true

Route inbound SMS to ElevenLabs. On by default; set to false to skip SMS configuration for numbers that don't support it.

Response

Successful Response

phone_number_id
string
required

Phone entity ID