Skip to main content

How to create a 10DLC campaign

Creating a campaign is the second step to becoming compliant with 10DLC rules. Read on to learn how you can create campaigns.

Telnyx Engineering avatar
Written by Telnyx Engineering
Updated yesterday

How to create a 10DLC campaign

If your business is sending outbound text messages using 10-digit long code (10DLC) Local phone numbers in the US, you're required to register for 10DLC. In this guide, we'll show you how to complete the second step of this process by registering campaigns, using tools provided in the Telnyx Mission Control Portal.

Pre-requisites

Every campaign must be associated with a brand. If you haven't already registered your brand, you'll need to do that before you can activate a campaign and send messages. Follow this guide to complete this first step before moving onto creating a campaign.

Additionally, you will want to ensure that your brand has a good Trust Score, as A2P 10DLC message throughput is determined based on your Trust Score and your Campaign Use Case. Learn more on throughput and Trust Scores in this article.

Creating a 10DLC campaign in the Mission Control Portal

Once you’ve created a Business Brand in Mission Control Portal, head to the Messaging section > Compliance > and then to the 10DLC Campaigns tab. From here, you can get started on creating a campaign.

Creating a 10DLC campaign using the Telnyx API

If you'd prefer to create your brand using a simple API command, you can find details in our API reference documentation.

Information you'll need to register your 10DLC campaigns

A campaign contains information about the messages you intend to send. You'll be asked for the following information when registering a 10DLC campaign.

What is message flow?

When adding a new campaign, "Message Flow" refers to the process of how users opt into the campaign. For example, users might visit a website and add their phone number to agree to receive messages. This information needs to be added when registering a 10DLC campaign.


Please note that the length of the "Message Flow" description should be between 40 and 2048 characters.

Item

Description

Brand

The 10DLC brand you want to associate this campaign with.

Use case

The use case that best matches your campaign:

  • Two Factor Authentication

  • Alerts/Notifications

  • Agents and Franchises

  • Carrier Exemptions

  • Charity

  • Customer Care (Conversational Messaging)

  • Delivery Notifications

  • Emergency Alerts

  • Fraud Alerts

  • Education

  • Marketing

  • Political

  • Polling/Voting

  • Public Service Announcements

  • Security

  • Social

  • Sole Proprietor

  • Sweepstakes

Messages sent that do not align with your registered use case may be subject to fines and throughput limitations and blocks.

Vertical

The industry vertical which best matches your business.

Campaign description

The description of your campaign.

Sample messages

Sample content that represents the messages you plan to send to end users. You may add multiple sample messages. You need one sample message for each selected use case. A marketing use case requires 2 sample messages. A Mixed use case requires a minimum of 2 sample messages but should have one for each selected use case.

Messages sent that do not align with the registered sample message can be flagged for review.

Campaign and content attributes

Indicate which content attributes you will or will not be providing:

  • Subscriber opt-in

  • Subscriber opt-out

  • Subscriber help

  • Number pooling

  • Direct lending or loan arrangement

  • Embedded link

  • embedded phone number

  • Affiliate marketing

  • Age-gated content

Message Flow

The customers need to add information of how the users opt in to the campaign.

Example: The users visit the website and add their phone number to agree receiving the messages.

Opt-in Keywords

Required field.

Example: START, JOIN, YES

Opt-in Message

Opt-out Keywords

Opt-out Message

Help Keywords

The end users should be able to text in a keyword to receive help. Those keywords must be provided as part of the campaign registration request.

Example keyword: HELP

Help Message

Field

Min length

Max length

Campaign description

40

4096

Help message

20

320

Message Flow

40

2048

Opt in Message

20

320

Opt out Message

20

320

Opt-in Keywords

255

Opt-out Keywords

255

Help Keywords

255

Next steps after registering your campaign

The next step after you’ve registered your campaign is it will be reviewed and either approved or declined. We will send automatic status update emails for every campaign to the username email on the account. If you would like for more email addresses to receive 10dlc status notifications please ask your CSM to add the email. If you have no csm you can request the addition by messaging 10dlcquestions@telnyx.com. Once you have received the "Approved" status notification for the campaign you assign numbers to it and begin sending! Congrats :).

Note: If you are receiving an "invalid date" or TCR Creation Failed status for your campaign in the Telnyx portal then this indicates that TCR (the regulating body of US local text messaging) has rejected the campaign due to a technical issue with your submission such as a character requirement was missed or the wrong number of sample messages was added (you must have at least one sample message per use case selected so if you select Mixed and then have 5 sub Use Cases then you must have 5 sample messages). It is different than a carrier rejection. If you are having this issue please reach out to us at 10dlcquestions@telnyx.com and we will work with our messaging team to identify the failure reason. Then we will communicate the failure reason to you and the campaign will need to be re-created.

If you have any messaging compliance questions please reach out to us at 10dlcquestions@telnyx.com.

Did this answer your question?