Skip to main content
POST
Purchase numbers

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-Tenant-Id
string

Optional tenant context selector for JWT/partner key callers.

Body

application/json
phone_number
string
required
Example:

"+14155551234"

provider
enum<string>
default:twilio
Available options:
twilio,
plivo
label
string
number_type
string
agent_id
integer

Response

Numbers purchased

data
object | null
message
string | null
meta
object | null
request_id
string | null