US 10DLC API Installation
A quick start to install a US 10 DLC number
To setup a new channel to send SMS messages using a United states 10 digit long code number the following steps are required
API Access
The following API requests can only be made using a valid access key and attached to an access role with the an access policy that at least specifies the permissions to the resources outlined in each section below.
Find an available number
If you do not already have a US 10DLC number available in your workspace you can find one to purchase
Example
The following example will return the first available US local number required for use with 10DLC registration.
Purchase a number
Once you have found an available number you can purchase this by providing the number (in E.1624 format) and the country (using a two digit ISO code).
A successful request to this endpoint will start a recurring monthly subscription based on the monthly cost of the number
The following example will purchase the number if it still available and you have sufficient balance in your workspace wallet. Provide number in E.1624 format and country in 2 digit ISO code (e.g. US)
Register a new brand with the campaign registry
After creating a brand, this will be submitted for approval by the campaign registry. The brand must be approved before you can register a campaign with the campaign registry. Brand registration make take some time.
You can find the full list of brand management endpoints here
The following example will create a new brand that will be submitted for registration with the campaign registry.
(Optional) Submit brand for external vetting
If your brand is not being accepted or your company is not part of the Russell 3000 stock index you can also request additional vetting. For brands that are not part of the Russell 3000 stock index this can provide access to higher messaging throughputs (depending on your vetting score)
The following example will create a new brand vetting request that will be submitted for registration with the campaign registry. You must have previously created a brand
Register a new campaign with the campaign registry
After creating a campaign, this will be submitted for approval by the campaign registry. The campaign must be approved before you can associate this with an SMS channel. Campaign registration can take 1-2 weeks to be approved.
You can find the full list of campaign management endpoints here
The following example will create a new campaign that will be submitted for registration with the campaign registry. Your associated brand must be approved
Install a channel connector
The following example will create a new SMS connector with an approved 10DLC campaign and US local number:
Get your channel id
Once you have created your SMS connector, this will create an SMS channel. You can then get your channel ID to before setting up channel webhooks
The following example will get the connector you have created in the previous step. Parse the channel.channelId
to get the id of your new SMS channel
Setup channel message webhooks
Once your channel has been installed you will then need to setup a webhook subscription to receive status updates and inbound messages
The following requests example will create a new SMS subscription for inbound and outbound messages
Inbound messages
Outbound messages
Last updated