This page is for Twilio customers who need to register a business for A2P 10DLC. The information in this page also applies to Independent Software Vendors (ISVs) who need to register their customers' businesses.
This page covers the business information that The Campaign Registry (TCR) requires for A2P 10DLC registration, as well as the messaging Campaign details required to register an A2P 10DLC Campaign.
The required information is presented in "parameter" format (e.g., brand_name
). This is for the benefit of ISVs who need to use the REST APIs for registering multiple businesses. If you're not an ISV, you still need to provide the same business information, but you can ignore the formatting of the parameter names since you can (and should) use the Console for registration.
Registrations for sole proprietors require slightly different information than other types of businesses, so please read the Sole proprietors section carefully.
If the business is a sole proprietorship in the US or Canada, it must register for A2P 10DLC as a "Sole Proprietor Brand", except if the business has an EIN or a Canadian Business Number.
If a Sole Proprietorship does have an EIN or other tax ID, The Campaign Registry requires the business to register as a Low-Volume Brand or a Standard Brand. In these cases, do not register the business as a Sole Proprietor Brand, because doing so will incur fees and will impact the business' ability to send A2P 10DLC messages. Follow the instructions for Standard and Low-Volume Brands in this doc, as well as in the relevant onboarding guides.
The information needed to register a Sole Proprietor Brand is listed in the table below. Click on a parameter name to learn how to format the associated information, along with some helpful hints.
Parameter name | Short Description |
---|---|
brand_name | The business name. For sole proprietorships, this is usually the first and last name of the proprietor. |
first_name | The first name of the business' authorized representative |
last_name | The last name of the business' authorized representative |
mobile_phone_number | The mobile phone number to use for the one-time passcode verification request |
The email address of the business' authorized representative | |
customer_name | The name of the business (for the mailing address) |
street | The number and street of the business address |
street_secondary | (optional) Additional business address information, if necessary. E.g., "Suite" or "Attention" |
city | The city of the business address |
region | Two-letter abbreviation for the state or province of the business address |
postal_code | The postal/ZIP code of the business address |
iso_country | The ISO country code of the business address |
vertical | (optional) The term that best describes the business' industry |
If the business is not a Sole Proprietor as defined above, collect the information listed in the table below.
Click on a parameter name to learn how to format the associated information, along with some helpful hints.
Parameter name | Short Description |
---|---|
business_name | The business name |
business_type | The legal structure of the business |
business_industry | The industry that most closely matches that of the business |
business_registration_identifier | The country-specific tax identification number for the business |
business_registration_number | The business tax identification number of the type specified in the business_registration_identifier parameter |
social_media_profile_urls | The URL(s) for the business' social media accounts (i.e. LinkedIn, Facebook, Twitter) |
website_url | The URL for the website of the business |
business_identity | The type of business identity (direct customer or ISV/reseller) |
business_regions_of_operation | The region(s) in which the business operates |
first_name | The first name of the business' authorized representative |
last_name | The last name of the business' authorized representative |
business_title | The exact job title of the business' authorized representative |
job_position | The position of the business' authorized representative |
phone_number | The phone number of the business' authorized representative |
The email address of the business' authorized representative | |
customer_name | The name of the business (for the mailing address) |
street | The number and street of the business address |
street_secondary | (optional) Additional business address information, if necessary. E.g., "Suite" or "Attention" |
city | The city of the business address |
region | Two-letter abbreviation for the state or province of the business address |
postal_code | The postal/ZIP code of the business address |
iso_country | The ISO country code of the business address |
stock_exchange | The stock exchange on which the business' stock is traded (if applicable) |
stock_ticker | The business' stock ticker symbol (if applicable) |
company_type | Indicates whether the business is public or private |
brand_contact_email | The email address of a Brand representative who can complete the 2FA |
skip_automatic_sec_vet | Only for Low-Volume Standard Brand registrations, 527 political organizations, or those with Campaign Verify tokens: set to true . |
Sole Proprietor only
The real business name. For Sole Proprietor businesses, this is usually the proprietor's first name and last name, but a Doing Business As (DBA) name is also accepted.
If the customer is not a business entity but instead is a hobbyist, college student, etc., use their first name and last name.
The business name
If you're registering a US entity, enter the exact legal business name as registered with the EIN, which can be found on the CP 575 EIN Confirmation Letter.
Do not use the legal business name found on the W2 or W9 forms as they may differ from the CP 575 notice.
If you've misplaced your CP 575 notice, you may request a 147c letter from the IRS and use the information therein for registration.
If the business name spans multiple lines on the CP 575 / 147c letter, input all the lines above the address line.
In the example CP 575 letter below, the business name is "ACME INC".
The legal structure of the business
Allowed values:
Co-operative
Corporation
Limited Liability
Non-profit Corporation
Partnership
If the business is a government organization, the value must be Non-profit Corporation
.
The industry that most closely matches that of the business
If the business is a government organization, the value must be GOVERNMENT
.
If the business is a non-profit agency, the value must be NOT_FOR_PROFIT
.
Allowed values:
AGRICULTURE
AUTOMOTIVE
BANKING
CONSTRUCTION
CONSUMER
EDUCATION
ELECTRONICS
ENGINEERING
ENERGY
FAST_MOVING_CONSUMER_GOODS
FINANCIAL
FINTECH
FOOD_AND_BEVERAGE
GOVERNMENT
HEALTHCARE
HOSPITALITY
INSURANCE
JEWELRY
LEGAL
MANUFACTURING
MEDIA
NOT_FOR_PROFIT
OIL_AND_GAS
ONLINE
PROFESSIONAL_SERVICES
RAW_MATERIALS
REAL_ESTATE
RELIGION
RETAIL
TECHNOLOGY
TELECOMMUNICATIONS
TRANSPORTATION
TRAVEL
Allowed values:
EIN
- US - Employer Identification NumberDUNS
- US - Dun & Bradstreet NumberCBN
- Canada - Canadian Business NumberCN
- Great Britain - Company NumberACN
- Australia - Australian Company Number from ASICCIN
- India - Corporate Identity NumberVAT
- Estonia - VAT NumberVATRN
- Romania - VAT Registration NumberRN
- Israel - Registration NumberOther
If the business has a US entity or an International Tax ID, use EIN
. Do not use a DUNS number.
The country-specific tax identification number for the business
The value and format depends on the business_registration_identifier
specified.
If using a business_registration_identifier
of CBN
, provide the first nine-digits only.
Examples:
business_registration_identifier
is EIN
, the business_registration_number
must be in EIN format. E.g., 00-0000000
.business_registration_identifier
is DUNS
, the business_registration_number
must be in DUNS format. E.g., 00-000-0000
.This is the website of the business. (If you're an ISV, this is your customer's business website.)
This website must be functional, and it must bear some relationship with the business_name
.
The URL provided undergoes an automated verification process. A screenshot is captured and is evaluated against the A2P 10DLC compliance rules. This compliance check is a mandatory step in the registration process.
The type of business — either a direct customer or a reseller
If you're not registering a business that is an ISV, then the value must be direct_customer
.
Allowed values:
direct_customer
isv_reseller_or_partner
unknown
The region(s) in which the business operates
Allowed values:
AFRICA
ASIA
EUROPE
LATIN_AMERICA
USA_AND_CANADA
The first name of the business' authorized representative
If the company is a Sole Proprietorship, this is the Sole Proprietor's first name.
The last name of the business' authorized representative
If the company is a Sole Proprietorship, this is the Sole Proprietor's first name.
The exact job title of the business' authorized representative
The position of the business' authorized representative
Allowed values:
Director
GM
VP
CEO
CFO
General Counsel
Other
The phone number of the business' authorized representative in E.164 format
Sole Proprietor only
This mobile number is critical in the registration process and is used for sending a One Time Password (OTP) verification request to the sole proprietor, which they must respond to.
This must be a valid US or Canadian mobile number.
This cannot be a number which you've acquired from a CPaaS provider such as Twilio.
This mobile number can only be used a maximum of three times across all A2P Brand registrations with TCR. If your the business is registered for A2P 10DLC with another vendor, that counts towards this limit.
The email address of the business' authorized representative
This must be a well formatted address with a valid domain and cannot be a disposable address.
This email address can only be used a maximum of ten times across all A2P Brand registrations with TCR. If the business is registered for A2P 10DLC with another vendor, that counts towards this limit.
The name of the business (for the mailing address)
The number and street of the business address
Example: 23 Main Street
This address can only be used a maximum of ten times across all A2P Brand registrations with TCR. If the business is registered for A2P 10DLC with another vendor, that counts towards this limit.
(optional) Additional business address information, if necessary
Examples:
Suite 221
Attention: John Smith
The city of the business address
Example: San Francisco
Two-letter abbreviation for the state or province of the business address
Example: CA
for California
The postal/ZIP code of the business address
Example: 90210
The ISO country code of the business address
Example: US
The stock exchange on which the business' stock is traded (if applicable)
Allowed values:
AMEX
AMX
ASX
B3
BME
BSE
FRA
ICEX
JPX
JSE
KRX
LON
NASDAQ
NONE
NYSE
NSE
OMX
OTHER
SEHK
SGX
SSE
STO
SWX
SZSE
TSX
TWSE
VSE
The business' stock ticker symbol (if applicable)
Example: TWLO
for Twilio
Indicates whether the business is public, private, a non-profit, or governmental organization
Allowed values:
government
non-profit
private
public
TCR requires email addresses for public, for-profit brands to complete authentication and brand personnel attestation via 2FA.
Validation of Brand's business email address will occur and the following types of email addresses will result in a brand failure:
This parameter is a Boolean that indicates whether or not the business should skip automatic secondary vetting.
This parameter is optional; the default value is false
.
Only set this parameter as true
in the following situations:
Sole Proprietor only
The industry that most closely matches that of the sole proprietor's business
Allowed values:
AGRICULTURE
COMMUNICATION
ENERGY
ENTERTAINMENT
FINANCIAL
GAMBLING
GOVERNMENT
HEALTHCARE
HOSPITALITY
HUMAN_RESOURCES
INSURANCE
LEGAL
MANUFACTURING
NGO
POLITICAL
POSTAL
PROFESSIONAL
REAL_ESTATE
RETAIL
TECHNOLOGY
TRANSPORTATION
A Campaign is a collection of information about a business' messaging use case, i.e. what kinds of messages the business wants to send and how customers can opt in and out.
You can wait until a Brand has been approved by TCR to collect this information. The Use Cases available to a Brand depends on the Brand type.
A Brand (i.e., a business registered with TCR) may have more than one Campaign. In that case, the business needs to provide these details for each Campaign.
The following Help Center articles may be helpful in collecting this information:
The table below lists the information needed to register a Campaign. Click on a parameter name to learn how to format the associated information, along with some helpful hints.
Parameter name | Short Description |
---|---|
description | Detailed description of the messaging campaign |
message_flow | Details how the business' end users opt in to the messaging campaign |
message_samples | Sample messages that are representative of the Campaign's messages |
us_app_to_person_usecase | Which A2P use case describes this campaign |
has_embedded_links | Boolean indicating whether this campaign sends messages containing URLs |
has_embedded_phone | Boolean indicating whether this campaign sends messages containing phone numbers |
opt_in_message | (optional) The auto-reply message sent to end users who opt in to the campaign via keyword |
opt_out_message | (optional) The auto-reply message sent to end users who opt out of the campaign via keyword |
help_message | (optional) The auto-reply message sent to end users who send a help keyword |
opt_in_keywords | (optional) The keywords end users send in order to opt in to the campaign's messages |
opt_out_keywords | (optional) The keywords end users send in order to opt out of the campaign's messages |
help_keywords | (optional) The keywords end users send in order to get help |
A detailed description of the purpose of the messaging Campaign. Must be between 40 and 4096 characters.
The description should include who the sender is, who the recipients are, and why messages are being sent to the recipients.
This description must align with the us_app_to_person_usecase
(described below).
Example: This Campaign will send weekly marketing messages about sales and offers from Acme Sandwich Company to end customers who have opted in
Note: If the business is a financial institution engaged in direct, first-party lending to its customers, indicate "Direct Lending" in the Campaign description so that the review team can properly set this attribute before submitting the registration to TCR. Please indicate this even if the Campaign use case is not directly related to the offer of lending services (e.g. OTP).`
A detailed description of how end users opt in (consent) to receiving the Campaign's messages. Must be between 40 and 2049 characters in length.
If multiple opt-in methods can be used for the same campaign, they must all be listed.
If a website is used for opting in:
Understanding the opt-in mechanism is critical to the acceptance of the Campaign by TCR.
Example: End users opt-in by visiting www.example.com and adding their phone number. They then check a box agreeing to receive text messages from Acme, Inc. Additionally, end users can also opt-in by texting START to (111) 555-3333 to opt in. Terms and Conditions at www.example.com/tc. Privacy Policy at www.example.com/privacy
An array (list) of messages that are representative of the Campaign's messages. Minimum of two messages. Maximum of five messages. Each message must be between 20 and 1024 characters in length.
us_app_to_person_usecase
(described below).[]
to indicate variable content.Example: This is a message from the Acme Sandwich Company. Your order for [sandwich type, other item] will be delivered by [time] on [date]. If you have questions or would like to change your order schedule, please call 333-444-1212. If you would like to opt out of future notifications like this, text STOP in reply to this message.
The use case for the messaging Campaign, i.e., the reason for sending messages in this Campaign
The Use Cases available differ based on the type of Brand registration. The Use Case selected impacts the available messaging throughput, and pricing differs by Use Case.
Learn more about A2P 10DLC throughput in the Message throughput (MPS) and Trust Scores for A2P 10DLC in the US Help Center article.
2FA
- Any authentication or account verification such as one-time-passcodes (OTP)ACCOUNT_NOTIFICATION
- Notifications about the status of an account or related to being a part of an accountCUSTOMER_CARE
- Support, account management, and other avenues of customer interactionDELIVERY_NOTIFICATION
- Information about the status of a deliveryFRAUD_ALERT
- Messaging about potential fraudulent activity such as spending alertsHIGHER_EDUCATION
- Message campaigns from colleges, universities, and other education institutionsMARKETING
- Promotional content such as sales and limited time offersMIXED
- A campaign that covers multiple use cases such as Customer Care and Delivery Notifications.
POLLING_VOTING
- For conducting polling and voting, such as customer surveys. Not for political use.PUBLIC_SERVICE_ANNOUNCEMENT
- Public service announcements (PSAs) to raise audience awareness about a given topicSECURITY_ALERT
- Notification of a compromised system (software or hardware related)LOW_VOLUME
- A campaign that covers multiple use cases, but has a lower monthly fee than the MIXED
Use Case (above) and is fixed at the lowest throughput tier.Special Use Cases are Use Cases that may qualify for increased messaging throughput and/or reduced carrier fees compared to Standard Brand Use Cases. Some special use cases are sensitive or critical in nature, and require additional approval steps.
Learn more about Special Use Cases, pricing, and throughput in the Special Use Cases for A2P 10DLC Help Center article.
AGENTS_FRANCHISES
- For a Brand that has multiple agents, franchises or offices in the same Brand vertical/industry, but require individual localized numbers for each agent/location/office.CHARITY
- Communications from a registered charity or 501(c)(3) non-profit aimed at providing help and raising money for those in need. Limited to 501(c)(3) nonprofits. Does not include religious organizations.K12_EDUCATION
- For virtual learning and related communication between students/faculty and parents of K-12 schools.PROXY
- Peer-to-peer app-based group messaging with proxy/pooled numbers. Supporting personalized services and non-exposure of personal numbers for enterprise or A2P communications.EMERGENCY
- Notification services designed to support public safety and/or health during natural disasters, armed conflicts, pandemics and other national or regional emergencies.POLITICAL
- Part of an organized effort to influence decision making of a specific group. Only available to 527 political organizations, 501(c)(4), 501(c)(5), and 501(c)(6) nonprofitsSOCIAL
- Communication between public figures or influencers and their communities.SWEEPSTAKE
- All sweepstakes-related messagingSOLE_PROPRIETOR
.Boolean indicating whether this Campaign sends messages containing URLs
Whenever possible, include example links in the message_samples
so that links can be verified.
Boolean indicating whether this Campaign sends messages containing phone numbers
Whenever possible, include any such phone numbers in the message_samples
so that the number(s) can be verified.
(optional) The auto-reply message that the Campaign sends to end users who send one of the opt_in_keywords
to a Campaign phone number. Must be between 20 and 320 characters in length.
This field is required if end users can text a keyword to a Campaign phone number in order to subscribe to a Campaign's messages.
The opt_in_message
should include:
(optional) The auto-reply message sent to end users who send one of the opt_out_keywords
to a Campaign phone number. Must be between 20 and 320 characters in length.
This field is required if the business is managing opt-out messages on their own (i.e., not using Twilio's default or Advanced Opt-out features).
The opt_out_message
must include:
(optional) The auto-reply message sent to end users who send one of the help_keywords
. Must be between 20 and 320 characters in length.
This field is required if the business is managing help messages on their own (i.e., not using Twilio's default or Advanced Opt-out features).
The help_message
may include the Brand name and additional support options and/or contact information.
(optional) A comma-delimited list of opt-in keywords that end users can send in order to opt in to the Campaign's messages. Maximum 255 characters in length.
This field is required if end users can text a keyword to a Campaign phone number in order to subscribe to a Campaign's messages.
(optional) A comma-delimited list of opt-out keywords that end users can send in order to opt out of the Campaign's messages. All characters must be alphanumeric. Maximum 255 characters in length.
This field is required if the business is managing opt-out messages on their own (i.e., not using Twilio's default or Advanced Opt-out features).
(optional) A comma-delimited list of help keywords that end users can send to a Campaign phone number in order to get help. Values must be alphanumeric. Maximum 255 character length
This field is required if the business is managing help messages on their own (i.e., not using Twilio's default or Advanced Opt-out features).
You're ready to proceed to one of the onboarding guides.
Direct customers (non-ISVs) should use the appropriate Console onboarding guide.
To make the registration process go smoothly, organize and format your customer data in a way that you can include in requests to Twilio's APIs, e.g., a JSON file.
ISVs should use the appropriate API onboarding guides:
social_media_profile_urls
The URL(s) for the business' social media accounts (i.e. LinkedIn, Facebook, Twitter)