10DLC Registration

This information pertains only to Zipwhip Wholesale, Commercial 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.

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 minumum 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 except for SOLE_PROP Legal name of the business
tax_identifier Required except for SOLE_PROP Tax ID of the business. Leave blank for Sole Proprietor.
business_type Required Type of business. Must be one of the following:

SOLE_PROP, PRIVATE, PUBLIC, NON_PROFIT, GOVERNMENT.

NOTE: You may enter SOLE_PROP for a business that qualifies for the Starter tier (≤5 lines and <1,000 messages p/day), even if they are not a sole proprietor.
business_vertical Required except for SOLE_PROP 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.

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 multipe use cases for a single campaign and group all lines under one campaign:

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

TMobile one-time Campaign Registration Fee

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

Amount Business Type Description
$0 Sole Proprietor There is no campaign registration fee for Sole Proprietors. Therefore, we are not accepting early registration for Sole Proprietors. Please do NOT submit registrations for Sole Proprietors at this time.
$50 Non-Sole Proprietor There is a $50 one-time campaign registration fee for businesses that are not Sole Proprietors. The $50 registration fee for non-Sole Proprietors will be waived if registered by November 15, 2021.

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
Sole Proprietor Starter $0.75 1,000 5
Non-Sole Proprietor Low Volume $2 2,000 Unlimited
Russell 3000 High Volume $10 200,000 Unlimited