Skip to main content
POST
Buy a phone number and set up its AI agent

Authorizations

Authorization
string
header
required

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

Headers

Idempotency-Key
string

UUID — when present, deduplicates repeat submissions. See /api-reference/idempotency.

Body

application/json
language
string
default:en
required
Maximum string length: 10
handle_calls
boolean
default:true
required
handle_texts
boolean
default:false
required
phone_number
string
Pattern: ^\+[1-9]\d{1,14}$
area_code
string
Pattern: ^\d{3}$
name
string
Maximum string length: 120
business_name
string
Maximum string length: 200
business_description
string
Maximum string length: 4000
agent_prompt
string
Maximum string length: 8000
greeting
string
Maximum string length: 500
voice
string
Maximum string length: 120
voice_model_tier
enum<string>
Available options:
standard,
mini
timezone
string
Maximum string length: 64
sms_prompt
string
Maximum string length: 8000

Response

Success

data
object
required