Skip to main content
POST
/
api
/
phone-numbers
{
  "phone_number": "+15551234567",
  "provider": "twilio",
  "sid": "AC...",
  "token": "auth_token...",
  "supports_inbound": true,
  "supports_outbound": true
}

{
  "success": true,
  "message": "<string>",
  "phone_number": {}
}
Import a phone number from a provider (Twilio or LiveKit SIP).
​
phone_number
string
required
Phone number in E.164 format (e.g., +12345678900).
​
provider
string
required
Provider type: twilio or sip.
​
supports_inbound
boolean
default:"false"
Whether the number supports inbound calls.
​
supports_outbound
boolean
default:"false"
Whether the number supports outbound calls.

​
Twilio Specific Parameters

​
sid
string
Twilio Account SID (required if provider is twilio).
​
token
string
Twilio Auth Token (required if provider is twilio).

​
SIP Specific Parameters (LiveKit)

​
sip_trunk_name
string
Name for the SIP trunk.
​
sip_username
string
SIP username for authentication.
​
sip_password
string
SIP password for authentication.
​
sip_server_address
string
SIP server address (required for outbound).
​
inbound_room_name
string
Room name pattern for inbound calls.
​
inbound_pin
string
Optional PIN for inbound calls.
​
media_encryption
string
default:"allow"
SIP media encryption mode (disable, allow, require).

​
Response

​
success
boolean
Indicates if the import was successful.
​
message
string
Success message.
​
phone_number
object
The created phone number object.
{
  "phone_number": "+15551234567",
  "provider": "twilio",
  "sid": "AC...",
  "token": "auth_token...",
  "supports_inbound": true,
  "supports_outbound": true
}