Purchase Phone Number
Phone Numbers
Purchase Phone Number
Buy a number from the inventory.
POST
Purchase Phone Number
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Inventory to buy from. Only the managed twilio inventory is purchasable (supports call transfer). The field discriminates so importing your own numbers can share this endpoint later.
Allowed value:
"twilio"E.164 number from GET /v1/agent/available-phone-numbers, e.g. +14155550123.
Maximum string length:
120Bind an agent to answer inbound calls right away.
Response
Document created, URL follows
E.164, e.g. +14155550123.
Available options:
livekit, twilio Inbound calls route to this agent; unbound numbers ring busy.
Available options:
provisioning, active, error, released What failed when status is error; empty otherwise.

