Create destination alpha sender

POST /v1/Services/{ServiceSid}/DestinationAlphaSenders
Account sid auth token

A Messaging Service resource to add, fetch or remove Destination and Default Alpha Sender IDs from a Messaging Service. Destination Alpha Sender can send to a particular ISO country code. Default Alpha Senders can send to all countries.

Path parameters

  • ServiceSid string Required

    The SID of the Service to create the resource under.

    Minimum length is 34, maximum length is 34. Format should match the following pattern: ^MG[0-9a-fA-F]{32}$.

application/x-www-form-urlencoded

Body

  • AlphaSender string Required

    The Alphanumeric Sender ID string. Can be up to 11 characters long. Valid characters are A-Z, a-z, 0-9, space, hyphen -, plus +, underscore _ and ampersand &. This value cannot contain only numbers.

  • IsoCountryCode string

    The Optional Two Character ISO Country Code the Alphanumeric Sender ID will be used for. If the IsoCountryCode is not provided, a default Alpha Sender will be created that can be used across all countries.

Responses

  • 201 application/json

    Created

    Hide headers attributes Show headers attributes
    • Access-Control-Allow-Origin string

      Specify the origin(s) allowed to access the resource

    • Access-Control-Allow-Methods string

      Specify the HTTP methods allowed when accessing the resource

    • Access-Control-Allow-Headers string

      Specify the headers allowed when accessing the resource

    • Access-Control-Allow-Credentials boolean

      Indicates whether the browser should include credentials

    • Access-Control-Expose-Headers string

      Headers exposed to the client

    Hide response attributes Show response attributes object
    • sid string | null

      The unique string that we created to identify the AlphaSender resource.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AI[0-9a-fA-F]{32}$.

    • account_sid string | null

      The SID of the Account that created the AlphaSender resource.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.

    • service_sid string | null

      The SID of the Service the resource is associated with.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^MG[0-9a-fA-F]{32}$.

    • date_created string(date-time) | null

      The date and time in GMT when the resource was created specified in ISO 8601 format.

    • date_updated string(date-time) | null

      The date and time in GMT when the resource was last updated specified in ISO 8601 format.

    • alpha_sender string | null

      The Alphanumeric Sender ID string.

    • capabilities array[string] | null

      An array of values that describe whether the number can receive calls or messages. Can be: SMS.

    • url string(uri) | null

      The absolute URL of the AlphaSender resource.

    • iso_country_code string | null

      The Two Character ISO Country Code the Alphanumeric Sender ID will be used for. For Default Alpha Senders that work across countries, this value will be an empty string
POST /v1/Services/{ServiceSid}/DestinationAlphaSenders 
curl \
 --request POST 'https://messaging.twilio.com/v1/Services/{ServiceSid}/DestinationAlphaSenders' \
 --user "username:password" \
 --header "Content-Type: application/x-www-form-urlencoded" \
 --data 'AlphaSender=Twilio&IsoCountryCode=FR'
Request example 
{"AlphaSender"=>"Twilio", "IsoCountryCode"=>"FR"}
Response examples (201) 
{
  "sid": "AIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "url": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/DestinationAlphaSenders/AIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "service_sid": "MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "alpha_sender": "Twilio",
  "capabilities": [
    "SMS"
  ],
  "date_created": "2015-07-30T20:12:31Z",
  "date_updated": "2015-07-30T20:12:33Z",
  "iso_country_code": "FR"
}