Before starting this process, first check and make sure the Toll-Free number you want to verifiy for SMS is assigned to a messaging profile. This is the most common mistake prior to submitting and you will have to start the submission process over if the number is not assigned.
(Note: If you are unable to assign the Toll-Free number to a messaging profile, the number will need to be provisioned. Please contact support@telnyx.com if this is the case.)
Step 1. The Business Details page.
Step 1.1 Business Name
In the Business Name field enter the legal Business Name of the company. This will be the registered business name on the business registration documentation from the country the business was registered in.
(Note: If you are a Sole Proprietor, you will place your literal name in this field, example: Clark Kent. Then the business name will be listed in the DBA field. )
Example for United States business registration EIN document, see below:
Example of Canada Provincial business registration document, see below:
Step 1.2 Corporate Website
In the Corporate Website field enter the complete URL website link for the business.
Step 1.3 Legal Entity or Organization Type
In the Legal Organization field select the designated entity type of the registered business.
Example:
When selecting Sole Proprietor, you will notice the Business Registration Number and Business Registration Type fields will be automatically removed. These fields are not required for this entity type. See image below.
When selecting Private Company, Publicly Traded Company, Charity / Non-Profit Organization, or Government entity types, the Business Registration Number and Business Registration Type fields are required.
In the image below, the Private Company organization type was selected along with the Business Registration Type of EIN.
Step 1.4 Business Registration Country
Select the Business Registration Country. This will be the country the business is registered in. For sole proprietors this will be the country the business is operating in. See image below.
Step 1.5 DBA or Brand Name
The doing business as name or brand name will be the branding throughout the rest of the toll-free submission. This is who the end user is opting into to receive SMS. See image below.
(Note: The DBA or Brand Name can be different from the Business Name.)
Step 1.6 First Name, Last Name, EMail, & Phone Number
Enter the business contact name, email address, and phone number. See image below.
(Note: This contact information should be on the About Page, Contact Page, or at the footer of the business website entered in earlier.)
(Note: The email entered must be branded with the official website domain. If an unbranded email is used, it must be visible on the website.)
Step 1.7 Status Update Webhook URL
This field is optional, but if you enter a webhook link, the Telnyx API will send a post to the webhook link with a status update on the Toll-Free Submission. See image below.
Step 1.8 Address
Enter the physical business address of the brand or DBA. This can be different from the address on the legal business registration document. The address can be enetred manually or the search address tool can be used to automatically populate the fields. This address should be on the business website. See image below.
The submission should look something like this below when this page is completed, Select Next and move to the Assign Numbers page.
Step 2 Assigning a Number
On this page, a list of toll-free numbers will appear. Select “Assign” to all the numbers you want to assign to the Toll-Free submission.
(Note: When submitting six (6) or more Toll Free Numbers in a single Verification Request, a valid explanation will need to be provided in the additional use case details field on why multiple numbers are needed.)
After assigning a Toll-Free number. See image below.
(Note” If an error occurs here, “Toll-Free number not Provisioned.” This means that the number is not assigned to a messaging profile or it is still assigned to another carrier from a recent port or transfer of service prior to submission. If this error occurs please email tfverifictaion@telnyx.com or support@telnyx.com or open a chat via the Telnyx portal. Share a screenshot of the error and our team will escalate this issue to our messaging operations team.)
Select next and move onto the next page Use-Case Details.
Step 3 Use Case Details
This page is an explanation on why the Toll-Free SMS verification is needed.
Step 3.1 Expected Messaging Volume Per Month
This will be one of the following choices: 1,000, 10,000, 100,000, 250,000, 500,000, 750,000, 1M, 5M, 10M, or 10M+. See image below.
When choosing a monthly messaging volume, select what the projected volume will be scaled at after 6 months of onboarding.
(Note: If your Toll-Free number is verified for one of the messaging volume choices above, and you need the messaging volume increased later. The verified Toll-Free number and Request ID will have to be resubmitted in order to increase the messaging volume. This means the number will need to be taken offline while being re-verified and be unable to send SMS. If this is the case, please contact our team and we will expedite the process. The other option would be to submit a new identical submission with a new Toll-Free number with a higher messaging volume.)
Step 3.2 Use Case
Select a Use Case. Below is a list of Use Case choices.
SMS Use Cases:
2FA
App Notifications
Appointments
Auctions
Auto Repair Services
Bank Transfers
Billing
Booking Confirmations
Business Updates
Career Training
Chatbot
Conversational/Alerts
Courier Services & Deliveries
Emergency Alerts
Employee Alerts
Events & Planning
Financial Services
Fraud Alerts
Fundraising
General Marketing
General School Updates
HR/Staffing
Healthcare Alerts
Housing Community Updates
Insurance Services
Job DIspatch
Legal Services
Mixed
Motivational Reminders
Notary Notifications
Notifications
Order Notifications
Political
Public Works
Real Estate Services
Religious Services
Repair and Diagnostic Alerts
Rewards Program
Surveys
System Alerts
Voting Reminders
Waitlist Alerts
Webinar Reminders
Step 3.3 Summarize Use-Case
This field is also known as the use-case summary. This will explain what SMS is being sent and who is sending it. See example below
If only one of the listed Use Cases needed is such as Conversational/Alerts, then only this Use Case will be listed in the Use-Case Summary. See the example below.
Example for Use Case: Conversational/Alerts
Use-case summary
Campaign to send transactional text messages for Conversational/Alerts from Acme Health Care.
If any two or more of the listed Use Cases are needed, the selected Use Case will be MIxed. Then all needed use case types will be explained in the use-case summary.
See the example below for a company named Acme Health Care with a Mixed Use Case for 2FA, Conversational/Alerts, and Appointments. Each use case is listed in the Use-Case Summary.. See example below.
Example:
Use-case summary
Campaign to send transactional text messages for 2FA, Appointments, and Conversational/Alerts from Acme Health Care.
If this same company also needed a General Marketing Use Case for SMS, then this would be added to the Use-Case Summary field in addition to the previously needed Use Cases.
See the example below for a company named Acme Health Care with a Mixed Use Case for 2FA, Conversational/Alerts, Appointments, and General Marketing. Each use case is listed in the Use-Case Summary. See example below.
Example:
Use-case summary
Campaign to send transactional text messages for 2FA, Appointments, Conversational/Alerts, and Marketing & Promotional SMS from Acme Health Care.
Step 3.3 Message Content
In this field please list 2-3 sample messages. Please exclude any special characters and do not leave spaces between messages. The message must be branded with the DBA/Brand Name. Please email tfverification@telnyx.com if you would like message examples for each use case.
Step 3.4 Opt-In Workflow
This field is just a designation of the opt-in type. Opt-In workflow will be one of the following: Digital Opt-In, Written Opt-In, Verbal Opt-In, or Inbound Keyword Text. No other information is needed in this field.
Step 3.5 Additional Use-Case Details
This field is optional. This field is for non-designated use cases such as Testing. If no additional use-cases are needed just place N/A in this field.
Step 3.6 Opt-In Workflow Image URL
The opt-in method is a critical component of registration. In this field a link to the opt-in is required. This will be a link to a website page, a Google Doc, or an embedded link from a hosting site. These links must be public.
Example 1: Digital Opt-In - Mixed use case for 2FA, Appointments, and Conversational/Alerts.
Example 2: Digital Opt-In - MIxed use case for 2FA, Appointments, Conversational/Alerts, and Marketing & Promotional.
(Note: A Marketing & Promotional SMS opt-in must have an opt-in disclosure of its own with a compliant checkbox separate from the other use cases.)
Example 3: Verbal Opt-In (Over the Phone) - Mixed use case for 2FA, Appointments, and Conversational/Alerts.
This is a verbal conversation between the business representative and the customer. See below.
(Note: Marketing & promotional SMS cannot be added to verbal opt-in. Verbal consent is not a compliant method for obtaining marketing & promotional SMS opt-in.)
Example 4: Verbal Opt-In (In-Person) - Mixed use case for 2FA, Appointments, and Conversational/Alerts.
Example 5: Written Opt-In - Mixed use case for 2FA, Appointments, and Conversational/Alerts.
Example 6: Written Opt-In - MIxed use case for 2FA, Appointments, Conversational/Alerts, and Marketing & Promotional.
Example 7: Inbound Keyword Text
Transactional SMS example opt-in
Marketing & Promotional SMS example opt-in
Example 8: QR Code
Acme Healthcare Alerts
Scan to JOIN
To Receive Promotions, Product Updates, and Special Offers from Acme Healthcare. Message and data rates may apply. Msg frequency varies. Unsubscribe at any time by replying STOP. Reply HELP for help.
Privacy Policy: https://example.com/privacy-policy
Terms of Service: https://example.com/terms
Step 3.7 Opt-In Keywords
In this field the Opt-In keywords can be listed. These will be opt-in keywords specific to your opt and can be unique. If your opt-in does not have an opt-in keyword, then simply put N/A in this field for (not applicable)..
(Note: START/UNSTOP and STOP Keywords are by default programmed into your Telnyx messaging profile. The Default Telnyx messages are below. These messages can be edited in the Keywords Management section of the numbers assigned messaging profile.)
STOP: NETWORK MSG: You replied with the word "stop" which blocks all texts sent from this number. Text back "unstop" to receive messages again.
START/UNSTOP: NETWORK MSG: You have replied "start/unstop" and will begin receiving messages again from this number.
Step 3.8 Opt-In Message
This will be the confirmation message that is sent to the SMS recipient upon opting in.
Example:
[Brand name]: Thanks for subscribing to [use case(s)]! Reply HELP for help. Message frequency may vary. Message and data rates may apply. Consent is not a condition of purchase. Reply STOP to opt out.
Step 3.9 HELP Message
This will be the response that is sent to the SMS recipient requesting help. This should include one of the following contact methods of the business; phone number, website link, or email address.
Example:
[Brand name]: Please reach out to us at [website/email/phone number] for help.
(Note: By default Telnyx does not send this message in response to the Keyword HELP. This will need to be added to the Keywords Management section of the numbers assigned messaging profile. See example below.)
Step 3.10 Privacy & Terms Links
In these two fields links to the website Privacy Policy and Terms & Conditions pages are required.
(Note: The Privacy Policy must contain the following statement to be compliant.
No mobile information will be sold or shared with third parties for promotional or marketing purposes.)

