Amazon Pinpoint
User Guide

Requesting Dedicated Short Codes for SMS Messaging with Amazon Pinpoint

A short code is a number that you can use for high-volume SMS message sending. Short codes are often used for application-to-person (A2P) messaging, two-factor authentication (2FA), and marketing. A short code typically contains between three and seven digits, depending on the country or region that it's based in.

You can only use short codes to send messages to recipients in the same country where the short code is based. If your use case requires you to use short codes in more than one country, you have to request a separate short code for each country that your recipients are located in.

For information about short code pricing, see Amazon Pinpoint Pricing.

Important

If you're new to SMS messaging with Amazon Pinpoint, request a monthly SMS spend threshold that meets the expected demands of your SMS use case. By default, your monthly spend threshold is $1.00 USD. You can request to increase your spend threshold in the same support case that includes your request for a short code. Or, you can use a separate case. For more information, see Requesting Increases to Your Monthly SMS Spend Threshold for Amazon Pinpoint.

After we receive your request, we send you information about the costs associated with obtaining a short code in the country or region that you specified in your request. We also provide an estimate of the amount of time that's required to provision a short code in your country or region. It usually takes between 8–12 weeks to provision a short code, although this delay can be much shorter or much longer depending on the country or region where the short code is based.

Note

The fees associated with using short codes begin immediately after we initiate your short code request with carriers. You're responsible for paying these charges, even if the short code hasn't been completely provisioned yet.

Step 1: Open a Service Limit Increase Case

Open a case with AWS Support by completing the following steps.

To request a dedicated short code

  1. Sign in to the AWS Management Console at https://console.aws.amazon.com/.

  2. On the Support menu, choose Support Center, as shown in the following image.

  3. On the My support cases tab, choose Create case.

  4. Under Create case, choose Service limit increase.

  5. Under Case classification, complete the following sections:

    • For Limit type, choose Pinpoint SMS.

    • For Link to site or app which will be sending SMS, provide information about the website, application, or service that will send SMS messages.

    • For Type of messages, choose the type of messages that you plan to send using your short code.

    • For Targeted countries, enter the country or region that you want to purchase short codes in.

  6. Under Requests, complete the following sections:

    • For Resource Type, choose Dedicated SMS Short Codes.

    • For Limit, choose the type of messages that you plan to send using this short code.

    • For New limit value, enter the number of short codes that you want to purchase.

  7. Under Case description, for Use case description, provide the following information:

    Company information:

    • Company name.

    • Company mailing address.

    • Name and phone number for the primary contact for your request.

    • Email address and toll-free number for support at your company.

    • Company tax ID.

    • Name of your product or service.

    User sign-up process:

    • Company website, or the website that your customers will sign up on to receive messages from your short code.

    • How users will sign up to receive messages from your short code. Specify one or more of the following options:

      • Text messages.

      • Website.

      • Mobile app.

      • Other. If other, explain.

    • The text for the option to sign up for messages on your website, app, or elsewhere.

    • The sequence of messages that you plan to use for double opt-in. Provide all of the following:

      1. The SMS message that you plan to send when a user signs up. This message asks for the user's consent for recurring messages. For example: ExampleCorp: Reply YES to receive account transaction alerts. Msg&data rates may apply.

      2. The opt-in response that you expect from the user. This is typically a keyword, such as YES.

      3. The confirmation message that you want to send when customers send this keyword to your short code. For example: You are now registered for account alerts from ExampleCorp. Msg&data rates may apply. Txt STOP to cancel or HELP for info.

    The purpose of your messages:

    • The purpose of the messages that you plan to send with your short code. Specify one of the following options:

      • Promotions and marketing.

      • Location-based services.

      • Notifications.

      • Information on demand.

      • Group chat.

      • Two-factor authentication (2FA).

      • Polling and surveys.

      • Sweepstakes or contests.

      • Other. If other, explain.

    • Whether you plan to use your short code to send promotional or marketing messages for a business other than your own.

    Message content:

    • The message that you plan to send when customers opt in to your messages by sending you a specific keyword. Be careful when you specify this keyword and message—it may take several weeks to change this message. When we create your short code, we register the keyword and message with the mobile phone carriers in the country where you use the short code. Your message might resemble the following example: Welcome to ProductName alerts! Msg&data rates apply. 2 msgs per month. Reply HELP for help, STOP to cancel.

    • The response that you want to send when customers reply to your messages with the keyword HELP. This message has to include customer support contact information. For example: ProductName Alerts: Help at example.com/help or (800) 555-0199. Msg&data rates apply. 2 msgs per month. Reply STOP to cancel.

    • The response that you want to send when customers reply to your messages with the keyword STOP. This message has to confirm that the user will no longer receive messages from you. For example: You are unsubscribed from ProductName Alerts. No more messages will be sent. Reply HELP for help or (800) 555-0199.

    • The text that you plan to send as a periodic reminder that the user is subscribed to your messages. For example: Reminder: You're subscribed to account alerts from ExampleCorp. Msg&data rates may apply. Txt STOP to cancel or HELP for info.

    • An example of each type of message that you plan to send using your short code. Provide at least three examples. If you plan to send more than three types of messages, provide examples for all of them.

    Important

    Mobile carriers require us to provide all of the information listed above in order to provision short codes. We can't process your request until you provide all of this information.

  8. Under Contact options, for Preferred contact language, choose whether you want to receive communications for this case in English or Japanese.

  9. When you finish, choose Submit.

Step 2: Update Your SMS Settings in the Amazon Pinpoint Console

After we notify you that your short code has been provisioned, complete the following steps.

  1. Sign in to the AWS Management Console and open the Amazon Pinpoint console at https://console.aws.amazon.com/pinpoint/.

  2. On the All projects page, choose a project that the SMS channel is enabled in.

  3. In the navigation pane, under Settings, choose SMS and voice.

  4. Under Number settings, choose the short code.

  5. Under Default keywords, verify that the responses for the HELP and STOP keywords match the values that you specified in your request.

  6. Under Registered keyword, verify that the opt-in keyword and response match the values that you specified in your request.

  7. (Optional) If you want to specify additional keyword responses, or if you want to process inbound messages outside of Amazon Pinpoint, you can enable two-way SMS. For more information, see Two-Way SMS Settings.

  8. When you finish, choose Save.

Next Steps

You've registered a short code with wireless carriers and reviewed your settings in the Amazon Pinpoint console. Now you can use Amazon Pinpoint to send SMS messages with your short code as the origination number.

To engage an audience segment with an SMS campaign, see Amazon Pinpoint Campaigns.