Buy a phone number

POST {{2010-04-01-Accounts-AccountSid-IncomingPhoneNumbers.json-Url}}/2010-04-01/Accounts/:AccountSid/IncomingPhoneNumbers.json

Purchase a phone-number for your Twilio account. Afterwards you can use this number to send or receive SMS and calls.

Request Body

[{"name"=>"PhoneNumber", "value"=>"+12513060906", "datatype"=>"string"}, {"name"=>"AddressSid", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"ApiVersion", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"AreaCode", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"BundleSid", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"EmergencyAddressSid", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"EmergencyStatus", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"FriendlyName", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"IdentitySid", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"SmsApplicationSid", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"SmsFallbackMethod", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"SmsFallbackUrl", "value"=>"<uri>", "datatype"=>"string"}, {"name"=>"SmsMethod", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"SmsUrl", "value"=>"<uri>", "datatype"=>"string"}, {"name"=>"StatusCallback", "value"=>"<uri>", "datatype"=>"string"}, {"name"=>"StatusCallbackMethod", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"TrunkSid", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"VoiceApplicationSid", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"VoiceCallerIdLookup", "value"=>"<boolean>", "datatype"=>"string"}, {"name"=>"VoiceFallbackMethod", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"VoiceFallbackUrl", "value"=>"<uri>", "datatype"=>"string"}, {"name"=>"VoiceMethod", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"VoiceReceiveMode", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"VoiceUrl", "value"=>"<uri>", "datatype"=>"string"}]

HEADERS

Key	Datatype	Required	Description
`Content-Type`	string

RESPONSES

status: Created

{&quot;account_sid&quot;:&quot;ACB6&quot;,&quot;address_requirements&quot;:&quot;foreign&quot;,&quot;address_sid&quot;:&quot;ADeA&quot;,&quot;api_version&quot;:&quot;reprehenderit laborum Excepteur&quot;,&quot;beta&quot;:false,&quot;bundle_sid&quot;:&quot;BUB2&quot;,&quot;capabilities&quot;:{},&quot;date_created&quot;:&quot;incididunt ad&quot;,&quot;date_updated&quot;:&quot;consequat nostrud non Excepteur&quot;,&quot;emergency_address_sid&quot;:&quot;ADAd&quot;,&quot;emergency_status&quot;:&quot;Inactive&quot;,&quot;friendly_name&quot;:&quot;Excepteur qui aute occaecat&quot;,&quot;identity_sid&quot;:&quot;RI4F&quot;,&quot;origin&quot;:&quot;ex sit non&quot;,&quot;phone_number&quot;:&quot;incididunt&quot;,&quot;sid&quot;:&quot;PNFd&quot;,&quot;sms_application_sid&quot;:&quot;APD1&quot;,&quot;sms_fallback_method&quot;:&quot;put&quot;,&quot;sms_fallback_url&quot;:&quot;https://sqnVhokvKfX.ggVS&quot;,&quot;sms_method&quot;:&quot;delete&quot;,&quot;sms_url&quot;:&quot;http://KvTTK.eixDOBAKnXDodC&quot;,&quot;status&quot;:&quot;Duis est&quot;,&quot;status_callback&quot;:&quot;https://lukPySBKCSJZRDfZeLGCQEJiiZlrSGtT.slbsog2f2Byb3SNOpnvFCnKiEUbexVWC5tK9Qaj0IFkIVhVKN+mNB826euAwsZOYNBGrdhphsN&quot;,&quot;status_callback_method&quot;:&quot;HEAD&quot;,&quot;trunk_sid&quot;:&quot;TK29&quot;,&quot;uri&quot;:&quot;http://efvlxkNPQlPFtoHjtYEM.qceW6gOSsyL5X8uZPGhiRrpPWucrUmJlQexyf4Dl9T7ahcoPDgC3k2TRG&quot;,&quot;voice_application_sid&quot;:&quot;AP5b&quot;,&quot;voice_caller_id_lookup&quot;:true,&quot;voice_fallback_method&quot;:&quot;head&quot;,&quot;voice_fallback_url&quot;:&quot;https://YYJSXXIemHJDgyPulvPuSDhUfIJ.ofhsUNmlqzZSTo7nnhXYYLQgunn2ScfFWt4qoJ,M2zYA,&quot;,&quot;voice_method&quot;:&quot;PATCH&quot;,&quot;voice_receive_mode&quot;:&quot;voice&quot;,&quot;voice_url&quot;:&quot;https://lNOljQzheebolftPuuCa.qjzdVdF,m6lXjsq+rV4sijQkntubbHInkrQaJO2zBraF0&quot;}