Create phone number
A Messaging Service resource to add, fetch or remove phone numbers from a Messaging Service.
Path parameters
-
The SID of the Service to create the resource under.
Minimum length is
34
, maximum length is34
. Format should match the following pattern:^MG[0-9a-fA-F]{32}$
.
POST
/v1/Services/{ServiceSid}/PhoneNumbers
curl \
--request POST 'https://messaging.twilio.com/v1/Services/{ServiceSid}/PhoneNumbers' \
--user "username:password" \
--header "Content-Type: application/x-www-form-urlencoded" \
--data 'PhoneNumberSid=PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'
Request examples
Create
{"PhoneNumberSid"=>"PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}
{"PhoneNumberSid"=>"PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}
{"PhoneNumberSid"=>"PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}
Response examples (200)
{
"sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"url": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/PhoneNumbers/PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"service_sid": "MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"capabilities": [
"MMS",
"SMS",
"Voice"
],
"country_code": "US",
"date_created": "2015-07-30T20:12:31Z",
"date_updated": "2015-07-30T20:12:33Z",
"phone_number": "+987654321"
}
Response examples (201)
Create
{
"sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"url": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/PhoneNumbers/PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"service_sid": "MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"capabilities": [],
"country_code": "US",
"date_created": "2015-07-30T20:12:31Z",
"date_updated": "2015-07-30T20:12:33Z",
"phone_number": "+987654321"
}
{
"sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"url": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/PhoneNumbers/PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"service_sid": "MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"capabilities": [
"MMS",
"SMS",
"Voice"
],
"country_code": "US",
"date_created": "2015-07-30T20:12:31Z",
"date_updated": "2015-07-30T20:12:33Z",
"phone_number": "+987654321"
}