Purchase Phone Number
Buy a number from the inventory.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
- PublicPhoneNumberPurchasePayload
- PublicSipNumberImportPayload
twilio buys from the managed inventory (supports call transfer); sip imports a number you already own at your carrier; see the sip request variant.
"twilio"E.164 number from GET /v1/agent/available-phone-numbers, e.g. +14155550123.
120Bind an agent to answer inbound calls right away.
Response
Document created, URL follows
E.164, e.g. +14155550123.
livekit, twilio, sip Inbound calls route to this agent; unbound numbers ring busy.
provisioning, active, error, released What failed when status is error; empty otherwise.
Whether the number can place calls (outbound and warm-transfer consult legs): managed twilio always, imported sip only when a termination was configured.
Imported sip numbers: the customer trunk's termination host.
Imported sip numbers: the inbound digest username. Passwords are never echoed.
Imported sip numbers: allowed source IPs/CIDRs.
Imported sip numbers: termination transport.
Imported sip numbers: the termination digest username. Passwords are never echoed.

