Requesting dedicated long codes for messaging

A long code (also referred to as a long virtual number, or LVN) is a standard phone number that contains up to 12 digits, depending on the country that it's based in. Long codes are typically meant for low-volume, person-to-person communication. In some countries, you can use long codes for sending test messages, or for sending low volumes of messages to your customers. In other countries, including the United States, senders are prohibited from using long codes to send Application-to-Person (A2P) messages, which includes the messages that you send from Amazon Pinpoint SMS.

Note

If you're new to SMS messaging with Amazon Pinpoint SMS, you should also request a monthly SMS and MMS spending threshold that meets the expected demands of your SMS and MMS use case. By default, your monthly spending threshold is $1.00 (USD). For more information, see Requesting increases to your monthly SMS, MMS, or Voice spending quota.

Requesting a long code

You can request a long code by opening a case in the AWS Support Center.

Important

To send messages to recipients in the United States or the US territories of Puerto Rico, US Virgin Islands, Guam and American Samoa, you must use either a short code, a 10DLC phone number, or a toll-free number. If you complete the following steps and request a long code for the United States or US territories of Puerto Rico, US Virgin Islands, Guam and American Samoa, your request will be rejected.

To request a dedicated long code by opening a case in the AWS Support Center

1. Open the Support Center Console at https://console.aws.amazon.com/support/home.

2. In the left hand navigation choose Your support cases.

3. ChooseCreate case.

4. In the Looking for service quota increases? window choose Create a case instead.

5. • For Service, choose Pinpoint SMS.

   • For Provide a link to the site or app which will be sending SMS messages - optional, provide information about the website, application, or service that will send SMS messages.

   • For What type of messages do you plan to send - optional, choose the type of message that you plan to send using your long code:

     • One Time Password – Messages that provide passwords that your customers use to authenticate with your website or application.

     • Promotional – 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 account alerts. Transactional messages must not contain promotional or marketing content.

   • For Which AWS Region will you be sending messages from - optional, choose the region that you will be sending messages from.

   • For Which countries do you plan to send messages to - optional, enter the country or region that you want to purchase short codes in.

   • In the How do your customers opt to receive messages from you - optional, provide details about your opt-in process.

   • In the Please provide the message template that you plan to use to send messages to your customers - optional field, include the template that you will be using.

6. Under Requests, complete the following sections:

   • For the Region, choose the AWS Region from which you will be sending messages.

     Note

     The Region is required in the Requests section. Even if you provided this information in the Case details section you must also include it here.

   • For Resource Type, choose Dedicated SMS Long Codes.

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

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

7. Under Case description, for Use case description, provide details about your use case.

8. (Optional) If you want to submit any further requests, choose Add another request.

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

10. When you finish, choose Submit.

After we receive your request, we provide an initial response within 24 hours. We might contact you to request additional information. Once approved, you can add keywords and response messages to your long code.

If we're able to provide you with a long code, we send you information about the costs associated with obtaining it. We also provide an estimate of the amount of time that's required to provision the long code. In many countries, we can provide you with a dedicated long code within 24 hours. However, in some countries and regions, it can take several weeks to obtain a dedicated long code for the SMS channel.

In order to prevent our systems from being used to send unsolicited or malicious content, we must consider each request carefully. We might not be able to grant your request if your use case doesn't align with our policies.