10DLC Registration

This information pertains only to Zipwhip Wholesale, Commercial API and Software Reseller partners that need to register their end-user lines for A2P 10DLC.

TMobile will require all landline 10-digit long code (10DLC) phone numbers that send text messages to mobile phones on TMobile’s network to be registered for Application-to-Person (A2P) messaging. Each 10DLC line must be registered with the line owner’s brand information and campaign use cases. Lines that are not registered for A2P may be blocked from sending messages to handsets on TMobile’s network.

NOTE: TMobile $50 Registration fee will be waived for all Low Volume businesses registered by 11/15/21.

CSV Upload

Zipwhip Commercial API and Software Resellers can bulk register their existing end-customer’s brands and campaigns by downloading the CSV template below and filling it in with the end-customer data.

Last updated 2022-11-18.

Once you have entered your end-customer’s brand and campaign info in the CSV file, you must upload the CSV file on the CSV Upload Page.

Uploading a CSV requires a unique Token provided to you by Zipwhip. If you don’t have a Token, you may request one here.

If an error occurs when parsing the CSV file, we will contact you and provide details of the error and how to correct it.

Note: You can re-upload the same CSV multiple times. If you upload data for the same phone number multiple times, the data from the most recent upload will overwrite data in previous uploads. For this reason, we recommend that you create a single CSV with all registration data in it and append or update that one CSV file and re-upload it when you need to submit changes or additions. That will ensure that Zipwhip always has the most up-to-date information.

See instructions below for filling in the template.

CSV Data Entry Columns

Enter one phone number per row in the CSV file. Fill in the details for each column based on the following.

Note: Many field values are case sensitive and must be entered as they appear below with ALL_CAPS and underscores for spaces.

Column Required Description
phone_number Required The provisioned phone number in 10-digit format (e.g. 2065551212)
vendor_customer_id Optional A unique identifier for referencing a business (brand) in your system of record.
use_case Required Enter a minimum of 1 and maximum of 5 use-cases from the following list. Separate multiple use cases by pipes (|). Accepted values:

2FA, ACCOUNT_NOTIFICATION, CUSTOMER_CARE, DELIVERY_NOTIFICATION, FRAUD_ALERT, HIGHER_EDUCATION, MARKETING, POLLING_VOTING, PUBLIC_SERVICE_ANNOUNCEMENT, SECURITY_ALERT

See description of Use Cases for more info.
display_name Required Friendly name of business
legal_business_name Required Legal name of the business
tax_identifier Required Tax ID of the business.
business_type Required Type of business. Must be one of the following:

PRIVATE, PUBLIC, NON_PROFIT, GOVERNMENT.
business_vertical Required See description of Verticals. Must be one of the following:

AGRICULTURE, AUTOMOTIVE, BEAUTY, COMMUNICATION, CONSTRUCTION, EDUCATION, ENERGY, ENTERTAINMENT, FINANCIAL, FITNESS, GAMBLING, GOVERNMENT, HEALTHCARE, HOSPITALITY, INSURANCE, LEGAL, MANUFACTURING, MEDIA, NGO, REAL_ESTATE, RETAIL, SPORTS, STAFFING, TECHNOLOGY, TRANSPORTATION, VETERINARY
stock_exchange Required only for PUBLIC The stock exchange of the brand. Must be one of the following:

NONE, NASDAQ, NYSE, AMEX, AMX, ASX, B3, BME, BSE, FRA, ICEX, JPX, JSE, KRX, LON, NSE, OMX, SEHK, SGX, SSE, STO, SWX, SZSE, TSX, TWSE, VSE, OTHER
stock_symbol Required only for PUBLIC The stock symbol of the brand
street Required Street address (e.g. 1000 Main Street)
city Required City name
state Required State or province. For the United States, please use 2 character codes (e.g. WA for Washington)
zip Required Zipcode or postal code. (e.g. 21012)
country Required 2 letter ISO-2 country code (e.g. US or CA)
website Optional The website of the business
contact_name Required First and last name of primary business contact
contact_phone Required Phone number of primary business contact
contact_email Required Email address of primary business contact
message_sample1 Required Sample text message that illustrates use-case. For example:

This is your appointment reminder for Tuesday, 8/31/21, at 10:00 AM with Dr. Smith
message_sample2 Required* Sample text message that illustrates use-case. *Provide one sample per use case.
message_sample3 Required* Sample text message that illustrates use-case. *Provide one sample per use case.
message_sample4 Required* Sample text message that illustrates use-case. *Provide one sample per use case.
message_sample5 Required* Sample text message that illustrates use-case. *Provide one sample per use case.
optin_message Required Min 20 characters. This should be an example of the first message the end-user receives once they opt-in. For example:

Tranquil Family Dentristry: Thanks for being on time. We will text when it is time to come in.
message_flow Required Min 40 characters. Describes how a consumer opts-in to the campaign, therefore giving consent to the sender to receive their messages. For example:

The end-user calls their provider and lets them know they have arrived. The provider asks if they would like to receive a text when their provider is ready to see them.
campaign_description Required Min 40 characters. This should describe the overall campaign and what it will be used for. For example:

This campaign will be used to message users after they arrive for an appointment so they can wait in their car and are sent a message when their provider is ready to see them.
content_has_lending Required True or False. Will this campaign include content related to Direct lending or other loan arrangements?
content_has_embedded_link Required True or False. Are you using an embedded link of any kind? Note that public URL shorteners (bitly, tinyurl) are not accepted.
content_has_embedded_phone Required True or False. Are you using an embedded phone number (except the required HELP information contact phone number)?
content_has_affiliate_marketing Required True or False. Is affiliate marketing being used or was used in the construction of this campaign?
content_has_age_gate Required True or False. Will this campaign include any age-gated content as defined by Carrier and CTIA guidelines?

Use Cases

When registering a campaign, you may select up to 5 of the following use cases.

ENUM description
2FA Two-Factor authentication, one-time use password, password reset
ACCOUNT_NOTIFICATION All reminders, alerts, and notifications. (Examples include: flight delayed, hotel booked, appointment reminders.)
CUSTOMER_CARE All customer care messaging, including account management and support
DELIVERY_NOTIFICATION Information about the status of the delivery of a product or service
FRAUD_ALERT Fraud alert notification
HIGHER_EDUCATION For campaigns created on behalf of Colleges or Universities and will also include School Districts etc that fall outside of any “free to the consumer” messaging model
MARKETING Any communication with marketing and/or promotional content
POLLING_VOTING Polling and voting
PUBLIC_SERVICE_ANNOUNCEMENT An informational message that is meant to raise the audience’s awareness about an important issue
SECURITY_ALERT A notification that the security of a system, either software or hardware, has been compromised in some way and there is an action you need to take

Verticals

When registering a brand, you may select on of the following business verticals. Choose the closest match.

ENUM description
AGRICULTURE Agriculture businesses and services.
AUTOMOTIVE Automotive related.
BEAUTY Personal Care or Beauty.
COMMUNICATION Communication and mass media.
CONSTRUCTION Construction, materials, and trade services.
EDUCATION Educational institutions providing education to students in educational settings.
ENERGY Energy and Utilities.
ENTERTAINMENT Entertainment, including gaming and dating services.
FINANCIAL Banking and financial institution.
FITNESS Fitness or Gyms.
GAMBLING Gambling and Lotteries.
GOVERNMENT Local, state or federal agencies, utilities.
HEALTHCARE Healthcare services, including hospital, health insurances.
HOSPITALITY Travel, hospitality and transportation.
INSURANCE Insurance products and services
LEGAL Legal services and law firms.
MANUFACTURING Goods producing industries.
MEDIA Radio and Media.
NGO Non-profit organization with valid tax-exempted status.
REAL_ESTATE Buying and Selling of residential and commercial properties.
RETAIL Consumer products and services, including Retails and eTails.
SPORTS Sports related.
STAFFING HR, Staffing or Recruitment.
TECHNOLOGY Information technology and information services.
TRANSPORTATION Transportation or logistics services.
VETERINARY Veterinary or Animal Care.

Brand, Campaign and Line Associations

Each Brand (business) can be associated with one or more Campaigns. Each Campaign can be associated with one or more Lines.

For example, a business with four text-enabled lines where three are used for customer service (CUSTOMER_CARE) and one is used for automated notifications (ACCOUNT_NOTIFICATION) could register one brand, two campaigns and four lines:

Alternatively, you could select multiple use cases for a single campaign and group all lines under one campaign:

Note: Message quotas are calculated at the Brand (business) level. If a Brand in the Low Volume tier has 10 lines, the total number of messages sent by that brand per day on TMobile’s network across all 10 lines cannot exceed 2k messages, or an average of 200 messages per line.

Registration Fees

TCR one-time Brand Registration Fee

The Campaign Registry, or TCR, is a company that works with North American mobile operators to manage registration of A2P 10DLC messaging campaigns. You can learn more about 10DLC registration here.

Each business must be registered as a Brand with TCR for a one-time fee.

Amount Description
$4 TCR one-time Brand Registration Fee

Note: The Brand Identity check is carried out for each Brand by TCR after its registration. They locate and confirm the existence of the Company you submitted by checking against several databases and utilizing best practice third party verification vendors. The Brand Identity Status is based on the accuracy* of the submitted information. The following information must be verified for the brand to obtain a “Verified” status:

EIN / Tax ID Legal Company Name Legal Company Address

This check also returns the following:

*Typos and outdated information can significantly affect this outcome

TCR On-demand Brand Vetting Score (optional)

Verified Brands can improve their terms by requesting that ZW initiate an on-demand vetting by TCR. TCR can then have the Brand Vetted through a TCR Vetting Partner. The Vetting Score, which can be obtained through TCR, refers to a deeper series of checks which include the “Reputation” in the messaging ecosystem of the Brand you submitted. Its result can determine whether a Brand is able to obtain better MNO terms. See how brand tier affects campaign volume below in the TCR Monthly Recurring Campaign Fees section.

Ammount Description
$40 TCR on-demand vetting. Cost is per vet.

TMobile one-time Campaign Registration Fee

Each campaign must be registered with TMobile for a one-time fee:

Amount Business Type Description
$0 Standard Brand There is NO LONGER a $50 one-time campaign registration fee.

TCR Monthly Recurring Campaign Fees

Each campaign you register will be charged a monthly recurring fee based on business type and message tier.

Business Type Tier Monthly Recurring Fee Max Messages per day per Brand on Tmobile network Max Lines per Brand
Standard Low Volume $2 2,000 Unlimited
Standard Low Mid Volume $10 10,000* Unlimited
Standard High Volume $10 40,000* Unlimited
Russell 3000** High Volume $10 200,000 Unlimited

* Requires $40 TCR brand vetting to qualify. TCR does not guarantee a change in brand tier as a result. See TCR On-demand Brand Vetting Score(optional) above

** Requires that TCR recognizes the brand on the Russell 3000 list based on the brand info submitted, including the Stock Symbol.