Skip to main content
POST
cURL

Notes

  • Creates a new phone number with optional inbound/outbound agent bindings

Authorizations

X-API-KEY
string
header
required

API Key for MCP server and external service authentication

X-API-SECRET
string
header
required

API Secret for MCP server and external service authentication

Body

application/json
phone_number
string
required

E.164 format phone number

area_code
integer

3-digit area code (US/Canada)

nickname
string
inbound_agent_id
string
outbound_agent_id
string
inbound_agent_version
integer
default:1
outbound_agent_version
integer
default:1
inbound_webhook_url
string
number_provider
string
default:twilio
outbound_trunk_id
string
phone_number_type
string

Response

200 - application/json

Phone number created successfully

message
string
status
string
error
string | null
data
object