Skip to main content

Purchase an ExoPhone

Purchase a new ExoPhone and add it to your account.

HTTP Request​

POST /v2_beta/Accounts/<account_sid>/IncomingPhoneNumbers

Request Parameters​

ParameterRequiredDescription
PhoneNumberYesThe phone number to purchase (from available numbers list)
VoiceUrlNoFlow URL to handle incoming voice calls
SMSUrlNoFlow URL to handle incoming SMS
FriendlyNameNoA friendly identifier for the number

Response​

{
"sid": "9eeafc8ab479a386dc95f854f9d7cd8a",
"phone_number": "+91XXXX30240",
"friendly_name": "XXXXX30240",
"capabilities": {
"voice": true,
"sms": true
},
"country": "IN",
"rental_price": "499.000000",
"currency": "INR"
}

Response Fields​

FieldDescription
sidUnique ExoPhone identifier
phone_numberPurchased phone number
friendly_nameDisplay name
capabilitiesVoice and SMS support flags
countryCountry of the number
rental_priceMonthly rental cost
currencyPrice currency