Quickstart: Apply for a short code
Important
Short code cannot be acquired on trial accounts or using Azure free credits. For more information, see the subscription eligibility page.
Prerequisites
- An Azure account with an active subscription. Create an account for free.
- An active Communication Services resource.
Get a short code
To begin provisioning a short code, go to your Communication Services resource on the Azure portal.
Apply for a short code
Navigate to the Short codes panel in the resource menu and click Get to launch the short code program brief application wizard. For detailed guidance on how to fill out the program brief application, see the program brief filling guidelines. This quickstart covers the application for US short code.
For UK short code, fill out UK short code application form.
For CA short code, download and fill out CA short code application form and email the form to acstns@microsoft.com. Include CA Short Code application in subject line and details on subscription ID and Azure Communication Services resource ID in the body of the email.
Short code prerequisites
The wizard on the Short codes panel presents a series of questions about the program and a description of content to be shared with the carriers for them to review and approve your short code program brief. Review the prerequisites tab for a list of the program content deliverables you need to attach with your application.
The short code program brief registration requires details about your messaging program, including the user experience (for example, call to action, opt-in, opt-out, and message flows) and information about your company. This information helps mobile carriers ensure that your program meets the CTIA (Cellular Telecommunications Industry Association) guidelines and regulatory requirements.
A short code program brief application consists of the following five sections:
Program Details
You first need to provide the program name and choose the country/region where you want to provision the phone number.
Select short code type
Configuring your short code is broken down into two steps:
- Select a short code type
- Select the short code features
You can select from two short code types: random or vanity. If you select a random short code, you get a short code randomly selected by the U.S. Common Short Codes Association (CSCA). If you select a vanity short code, you're required to provide a prioritized list of vanity short codes that you want to use for your program. If the first short code in your list isn't available to lease, the CSCA chooses an alternative from the list. For example: 234567, 234578, 234589. You can search the list of available short codes in the US Short Codes Directory.
After selecting a number type, you can then choose the message type and target date. Short code registration with carriers usually takes 8-12 weeks, so select a target date based on the registration period.
Note
Azure Communication Service supports multimedia messaging service (MMS) in private preview. Private preview includes access to SDKs and documentation for testing purposes that are not yet available publicly. Apply to become an early adopter by filling out the form for preview access to Azure Communication Services.
Program content details
This section requires you to provide details about your program. These details include recurrence of the program, program call to action, type and description of program, privacy policy, and terms of the program.
Contact Details
This section requires you to provide information about your company and customer care in the case that end users need help or support with the program.
Volume Details
This section requires you to provide an estimate of the number of messages you plan to send per user per month and disclose any expected traffic spikes as part of the program.
Template Information
This section captures sample messages related to opt-in, opt-out, and other message flows. This tab features a message samples view where you can review sample templates to help you create a template for your use case.
Azure communication service offers an opt-out management service for short codes that allows customers to configure responses to mandatory keywords STOP/START/HELP. Before provisioning your short code, you need to provide your preference to manage opt-outs. If you opt-in, the opt-out management service automatically uses your responses in the program brief for Opt-in/ Opt-out/ Help keywords in response to STOP/START/HELP keyword.
Review
Once completed, review the short code request details, fees, SMS laws and industry standards, and submit the completed application through the Azure portal.
The system automatically sends the program brief to the Azure Communication Services service desk for review. The service desk makes sure that the provided information is in the right format before sending it to all US mobile carriers for approval. The carriers then review the details of the short code program, a process that typically takes 8-12 weeks. Once carriers approve the program brief, you're notified via email. You can now start sending and receiving messages on this short code for your messaging programs.
Troubleshooting
Common questions and issues:
- Purchasing short codes is supported in the US only. To purchase phone numbers, ensure that:
- The associated Azure subscription billing address is located in the United States. You can't move a resource to another subscription at this time.
- Your Communication Services resource is provisioned in the United States data location. You can't move a resource to another data location at this time.
- Updating a short code application
- Once submitted, you can't edit, view, or cancel the short code application. If the Service desk team requires any updates to be made, you're notified via email and you're able to edit the application with the updates.
- If you'd like a copy of your application or for any issues, contact us.
- Cancelling a short code application
- Cancelling short code applications in the Azure portal isn't supported. If you'd like to cancel your application after submitting the program brief, contact us
Next steps
Related articles
- Familiarize yourself with the SMS SDK.