POST
/
v1
/
phone-numbers
{
  "_id": "<string>",
  "provider": "sip",
  "phone_number": "<string>",
  "friendly_name": "<string>",
  "sip_termination_uri": "<string>",
  "sip_trunk_username": "<string>",
  "sip_trunk_password": "<string>",
  "inbound_agent_id": "<string>",
  "outbound_agent_id": "<string>",
  "sip_infra_region": "global"
}

Body

application/json
phone_number
string
required

The phone number in E.164 format (e.g., +14155552671). Must include country code

provider
string
default:sip

Specifies this as a request to create an Import Phone Number (SIP provider) configuration

Allowed value: "sip"
friendly_name
string | null

A human-readable label for this phone number to help identify its purpose

sip_termination_uri
string | null

The SIP URI where calls to this number should be terminated

sip_trunk_username
string | null

Username for authenticating with the SIP trunk provider

sip_trunk_password
string | null

Password for authenticating with the SIP trunk provider

inbound_agent_id
string | null

ID of the AI agent that will handle incoming calls to this number

outbound_agent_id
string | null

ID of the AI agent that will be used when making outbound calls from this number

sip_infra_region
enum<string>
default:global

The infrastructure region for SIP routing. 'global' for worldwide routing, 'bd' for Bangladesh-specific routing, 'bd_link3' for Bangladesh Link3 IPTSP routing

Available options:
global,
bd,
bd_link3

Response

201
application/json
Successful Response
phone_number
string
required

The phone number in E.164 format, including country code (e.g., +14155552671)

_id
string

Unique identifier for this phone number record

provider
string
default:sip

Indicates this is an Import Phone Number (SIP provider)

Allowed value: "sip"
friendly_name
string | null

A human-readable label for this phone number

sip_termination_uri
string | null

The SIP URI where calls are terminated

sip_trunk_username
string | null

Username for SIP trunk authentication

sip_trunk_password
string | null

Password for SIP trunk authentication

inbound_agent_id
string | null

ID of the AI agent handling incoming calls

outbound_agent_id
string | null

ID of the AI agent used for outbound calls

sip_infra_region
enum<string>
default:global

The infrastructure region for SIP routing: 'global' or 'bd' (Bangladesh)

Available options:
global,
bd,
bd_link3