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 over a week ago

How to create a 10DLC campaign

If your business is sending application-to-person (A2P) text messages using 10-digit long code (10DLC) numbers in the US, you're required to register for 10DLC in order to avoid fees and penalties from mobile network operators. A2P messaging is defined as any messaging from or on behalf of a business, regardless of volume. 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 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.

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.


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

  • Conversational Messaging

  • Customer Care

  • 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.

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.

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

The opt in keywords the users need to text in order to start receiving messages from the campaign.

If your campaign does not support opt-in keywords, you do not need to provide this.

Opt-in Message

If your campaign supports opt-in keywords to start receiving messages from this campaign, you need to provide the auto response that will be sent to the end users when they opt in. The opt-in response should include the Brand name, confirmation of the opt-in process for recurring messages from the campaign, how to get help, and opt-out language.

Example: “Your Brand: You have been opted-in. For help, reply HELP. Reply STOP to opt-out".

If you do not support opt-in messages, you do not need to provide this.

Opt-out Keywords

Provide the keywords the users need to text in order to stop receiving messages from the campaign. Those keywords must be provided as part of the campaign registration process.

Opt-out Message

The auto response that will be sent to the end users when they opt-out in order to confirm that no further messages will be sent from your campaign to their numbers.

Example: "You have successfully been unsubscribed from Your Brand. You will not receive any more messages from this number."

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

The auto response that will be sent to the end users when they send the HELP keyword.

Example: “Your Brand. Please visit example.com/help to get support. To opt-out, reply STOP.""

Length requirements introduced to data fields

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" 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?