Hosted numbers provide you with an easy method to port your SMS enabled numbers to Sinch or to SMS messaging and other products to send and receive messages, on voice-enabled numbers (including landline numbers) that you already own.
Note: The SMS enablement process is only supported in United States and Canada.
To host and enable SMS messaging on an existing voice enabled number, log in to the Sinch Customer Dashboard and follow the steps outlined below:
- Select Numbers from the left menu and click the SMS hosting US/Canada option. The Host number page is displayed:
This page describes the steps to host a number.
Note: The above welcome screen is only displayed if you have never accessed the SMS hosting USA/Canada tab before.
The getting started wizard follows the same steps described in this guide, and the information provided below is still relevant.
Click GET STARTED to start the process. - The Add numbers dialog is displayed:
Add the number(s) you want to host, by entering them in the Phone numbers(s) field, in the E.123 format making sure to separate each number by a comma. Click ADD.
Note: You can add up to 500 numbers at a time.
You can also import a list of numbers from a CSV file by clicking the IMPORT option and uploading the CSV file containing your list of numbers (format: comma separated list).
- The NUMBER VERIFICATION tab on the Host number page is displayed:
You will now need to verify the number(s) you have added using one of two methods:
- Select the VERIFY BY OTP option and a verification code will be sent to the phone number using a voice call. Please enter the code in the Verify by OTP dialog displayed to verify your number.
Note: You can use this option if you are hosting just a few numbers. You will need to repeat the process to verify each number. - If you are hosting many numbers, we recommend you select the VERIFY OWNERSHIP BY INVOICE option, where you will be requested to send an email to orders@sinch.com attaching all the invoices related to the phone numbers that need to be verified. In most cases, it will take the Sinch team 1-3 days to review your documentation and verify number ownership.
Note: If you click on your number, you will be shown all the steps for the number hosting process and the different statuses that your number will go through.
Please select the correct project from Select Project drop down options. To learn more about projects, refer to the article What is a project and where do I find the key and secret?
- Once you verified your number the status of your number will change to Ready to enable SMS:
Click ENABLE SMS FOR NUMBERS.
- The Enable sms dialog is displayed:
Select the numbers that you want to enable for SMS from the list. Click NEXT.
- The Create letter of authorization to enable sms dialog is displayed:
To enable SMS for your number(s) you need a letter of authorization to allow Sinch to enable SMS for that number(s).
To create this letter of authorization (LOA) complete the following fields:
Friendly name
This is optional but it is recommended you specify a name, so your request is easily identifiable.
Region code
The SMS enablement process is only available for United States and Canada. Select your region code from these two options.
Email
Specify your enterprise (work) email address.
Note: Personal email addresses (Gmail, Hotmail) are not supported.
Campaign ID
Before you can use a number to send any A2P messages you need a valid Campaign ID to show this is a valid approved A2P campaign.
Select your Campaign ID from the drop-down list.
If you do not have a Campaign ID or want to create a new one, click the Create campaign ID link to create one. Refer to the How to create a 10DLC Campaign article for details of how to do this.
If you do not specify a Campaign ID you can still host the number on Sinch, but the number will not be SMS enabled and cannot be used to send SMS until you add a campaign ID.
Note: If your number has been previously text-enabled with a different provider, then skipping this step will interrupt your existing service. A campaign ID must be configured later to enable SMS.
NNID
A Net Number ID (NNID) is used to identify the service provider for a particular dialled number and also supports MVNO-OTT override data for text messaging for USA and Canada.
This is optional. In most cases, you will not need to set this. Sinch will set this value for you to ensure proper message routing across all carriers. However, if do you have NNID(s) configured on your account you can select your desired NNID from the drop-down list.
SMS app ID
A Service Plan is assigned to you when you create an account on the Customer Dashboard - this is required to send messages using the SMS API. The SMS app ID is used to uniquely identify the Service plan.
Note: SMS app IDs are referred to as Service Plan IDs on the SMS tab of the Sinch Customer Dashboard.
Use your default SMS app ID or if you have more than one, select your SMS app ID from the drop-down list.
LOA type
Select one of the two options:
- Direct – select this option if you are a direct Sinch customer
- Reseller – select this option if you are a Sinch partner or reseller.
Note: If you select the reseller option then the letter of authorization will state that the contract is between you (the reseller) and your end customer.
Current voice carrier
Specify your current carrier you are using for voice services for the number you want to host on Sinch.
Note: The LOA process will not affect your voice calling services and you may keep your numbers with your voice services provider without any porting required.
Note: All the fields on this form are mandatory except for the name field which is optional but recommended.
If you want to schedule the SMS enablement for a specified date and time to minimize any disruption to your existing messaging services, select the Schedule SMS enablement check box. Additional fields are displayed allowing you to select the date and time that you want the SMS enablement to take place.
Click NEXT.
- Enter the remaining information required to generate the letter of authorization:
Once you have entered the information requested, click SUBMIT.
- A confirmation box is displayed informing you that number hosting is in process:
The STATUS field is also updated accordingly.
- You will receive an email from Sinch via DocuSign requesting your signature. This is a required step of the SMS hosting Letter of Authorization process:
Review the document and sign it using DocuSign. The email will contain details of alternate signing methods in case you encounter any issues.
- Return to the Host number page on the customer dashboard. Once your signature has been processed, the STATUS field for your number will be updated to Done:
The process is now complete. Your number is now listed in the hosted numbers section and is ready to use for sending SMS messages.
Note: On average, the hosting process will take a few minutes when you are attaching a number to an existing 10DLC campaign. However, if you are attaching the number to a new campaign, campaign approval is a manual process that protects against fraud and ensures compliance with messaging best practices. In most cases, it will take the Sinch team 1-3 days to review your campaign.
For information about managing your hosted numbers refer to the Managing your Hosted Numbers article.
