Amazon Pinpoint
User Guide

Requesting Dedicated Short Codes for SMS Messaging with Amazon Pinpoint

A short code is a five-digit or six-digit number that's meant for high-volume SMS messaging. Short codes are often used for application-to-person (A2P) messaging, two-factor authentication (2FA), and marketing.

To use short codes in multiple countries, request a separate short code for each country. You can use a short code only to message the same country in which it was approved by wireless carriers.

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 receiving your request, AWS works with the wireless carriers to provision your short code on your behalf. This provisioning process typically takes 8–12 weeks to complete, but some carriers may require additional time to complete the process.

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.

To request a dedicated short code, complete the following steps.

Step 1: Open an Amazon Pinpoint SMS Case

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

  1. Sign in to the AWS Management Console, and go to the AWS Support Center.

  2. Choose Create case.

  3. For Regarding, choose Service Limit Increase.

  4. For Limit Type, choose Pinpoint SMS.

Step 2: Specify Your Request

Tell AWS Support that you're requesting a dedicated short code by completing the following steps.

  1. For Resource Type, choose Dedicated SMS Short Codes.

  2. For Limit, choose the type of message that you'll send with your short code:

    • One-time Passwords/Two-Factor Authentication – Messages that provide passwords to authenticate with your website or application.

    • Promotional/Marketing – Noncritical messages that promote your business or service, such as special offers or announcements.

    • Transactional – Important informational messages that support customer transactions, such as order confirmations or transaction alerts. Transactional messages must not contain promotional content.

  3. For New limit value, specify the number of short codes that you're requesting. Typically, this value is 1.

  4. (Optional) If you want to include multiple requests in this support case, choose Add another request. Then, specify the type of request.

    If you include multiple requests, provide the required information for each. For the required information, see the other sections within Requesting Support for SMS Messaging with Amazon Pinpoint.

Step 3: Describe Your SMS Use Case

Describe how you'll use your dedicated short code by completing the following steps.

  1. For Link to site or app which will be sending SMS, identify the website or application where your audience members will opt in to receive your SMS messages.

  2. For Type of messages, choose the type of message that you'll send using your short code: Transactional, Promotional, or One Time Passwords.

  3. For Targeted Countries, specify the country that you'll send SMS messages to with your short code.

  4. For Use Case Description, provide the following details, which AWS requires to register your short code with wireless carriers:

    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'll use for double opt-in. Provide:

      1. The SMS message that you'll 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'll send in response. 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'll 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'll use your short code for promotional or marketing messages for a business other than your own.

    Message content:

    • The message that you'll 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 may resemble the following example:

      Welcome to ProductName alerts! Msg&data rates apply. 2 msgs per month. Reply HELP for help, STOP to cancel.

    • The message that you'll send in response to the HELP keyword. This message must 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 message that you'll send in response to the STOP keyword. This message must confirm that messages are no longer sent to the user. For example:

      You are unsubscribed from ProductName Alerts. No more messages will be sent. Reply HELP for help or (800) 555-0199.

    • The text you'll use for a periodic reminder that the user is subscribed to your messages. For example:

      Reminder: You are 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'll send with your short code. Provide at least 3 examples, but if you are sending more than 3 types of messages, provide examples for all of them.

  5. When you finish, choose Submit.

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

After AWS notifies you that your short code is registered with the wireless carriers, 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 Projects page, choose the a project that uses the SMS channel.

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

  4. Under Short and Long Codes, choose the short code that AWS assigned to your account.

  5. Under Default keywords, verify that the messages for the HELP and STOP keywords match the values you provided to AWS Support.

  6. Under Registered keyword, verify that the opt-in keyword and message match the values you provided to AWS Support.

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

  8. When you finish making changes, 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.

To send an SMS message directly to a limited audience without creating a campaign, see Send Test Messages with Amazon Pinpoint.