Skip to main content
POST
Buy / Add Phone Number
string
required
Phone number in E.164 format (e.g., "+14151234567").
string
Display name for the phone number.
string
"twilio" or "sip" (auto-detected from fields if not specified).
string
SIP trunk termination URI. Required for SIP provider numbers.
string
SIP authentication username.
string
SIP authentication password.
string
SIP transport protocol: "tcp", "udp", or "tls" (default: "tls").

Search Available Numbers

First, search for available Twilio numbers:

Response

Buy a Number (Twilio)

Numbers are purchased through the workspace Twilio endpoint:
The number is automatically provisioned with inbound webhooks, SIP trunk, and status callbacks.

Connect Existing SIP Number

Add a number you already own via SIP:

Response

A payment method is required before purchasing or connecting phone numbers.