Phone Numbers
Buy Phone Number
Phone Numbers
Buy Phone Number
POST
/
phone_numbers
/
buy
Authorizations
Authorization
string
headerrequiredBearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
provider
enum<string>
default: twilioThe telephony provider.
Available options:
twilio phone_number
string
The phone number to buy. If null, a random phone number will be purchased.
Response
200 - application/json
uri
string
requiredThe uri of the phone number.
inbound_agent_id
string
The agent id that will be used for inbound calls. If null, the phone number will not receive any calls.
phone_number
string
requiredThe phone number including the country code.
account_id
string
requiredThe account id associated with the phone number.
created_at
string
requiredThe date the phone number was created.
updated_at
string
requiredThe date the phone number was last updated.
telephony
object
requiredThe telephony provider for the phone number.
webhooks
object[]
The webhooks of the phone number. This is used to fetch the agent at the start of the conversation.
id
string
requiredThe id of the phone number.