10DLC is a local 10-digit phone number that requires Brand & Use Case registration and supports throughput levels suitable for A2P SMS campaigns. 10DLC is sanctioned by mobile carriers for A2P messaging and is intended to provide a reliable user experience, better deliverability, and higher messaging speed. To find out more about 10DLC see the following
To setup a new channel to send SMS messages using a United states 10 digit long code number the following steps are required
Some of the following requests will lead to additional workspace charges. Ensure you before proceeding
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 .You can filter by country, prefix, number type and number capabilities.
Example
The following example will return the first available US local number required for use with 10DLC registration.
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)
You can set up a Web Hook subscription to be notified of any brand or campaign event. Brand and camping creation work in sync, and subscribing to all related events will automate the 10DLC registration process.
Brand Subscriptions
The Following example will Create a subscrscrition listing to all Brand Related events
A-Sync : this will start a background process that may require some time to complete. A Get call may be required to to retrieve the final result .
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 may 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.
A-Sync : this will start a background process that may require some time to complete. A Get call may be required to to retrieve the final result .
The final result of 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
To reduce the likelihood of rejection, ensure you are familiar with 10dlc registration examples and best practices. Specifically
Check this article for tips on how to write an effective Campaign description
Check this article on how to write an effective messageFlow
Most 10DLC rejections are caused by unclear or incomplete description and/or messageFlow
A-Sync : this will start a background process that may require some time to complete. A Get call may be required to to retrieve the final result .
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
The event you are subscribing to. For SMS channels either sms.outbound or sms.inbound
Yes
event[]
object
Event filters are inclusive, which means you will only get events for filters you add
No
eventFilters.key
string
If you do not want events for all events you can add a filter. Eventfilters are inclusive e.g. for each event filter you add you will get those events. Valid filters for channels are channelId
No
eventFilters.value
string
The filter value. In this case a channelid. You will get webhooks for this channel
No
service
string
The service that will be sending the webhooks. In this case channels
url
string
A valid HTTPS endpoint to receive the webhooks
Yes
Confirm a 10DLC Channels Readiness to send SMS traffic
A-Sync : this will start a background process that may require some time to complete. A Get call may be required to retrieve the final result
10DLC numbers can only send traffic to the USA when linked to a campaign. Number Campaign link is an A-sync process requiring confirmations from multiple carriers.
The bird will only consider a number linked if all major USA carriers acknowledge the links. Delays in carrier acknowledgment can vary between 15 minutes to several hours and are usually longer around peak linking hours (afternoon/evening USA Pacific time)
Based on whether you have subscribed or not to channel events, you can determine the readiness of a given channel in 2 ways
Option 1: you are subscribed to channel updates
if you have a "channel.updated" event subscription, each change in a channel status will trigger an event. You can associate those events to the number you have used to install the channel by referring to "identifier" field. A channel ready to send SMS will have "status": "active".
This could happen if the number linked to its campaigns is not acknowledged or the 10DLC registration experiences issues. In this case, the "useCaseStatus" 's value will not be "ok"
Before you can use a US 10DLC number to send SMS messages, you must be and campaign with an external registry called the campaign registry.
A successful request to this endpoint will mean you are charged a fee. If you later need to update or resubmit your brand there may be additional fees.
A successful request to this endpoint will mean you are charged a fee.
Once your brand status is approved you can then create your first . Brands can have multiple campaigns. A campaign describes what types of messages you will send from your SMS channel.
A successful request to this endpoint will mean you are charged a and a three month minimum commitment fee. If you later need to update or resubmit your brand there may be additional fees.
