Toll-Free Verification Guide
Before you can send your first outbound message from a Toll-Free phone number you must first "Verify" the number. Toll-Free Verification requires specific data to be submitted to ensure a successful verification process. The provided information helps identify the end business and ensures they have the proper measures in place to send compliant traffic. Below is a detailed guide on what is required for a submission. Incomplete submissions may be rejected if they do not contain the necessary fields.
Time line for approvals are normally 5 business days or less but can be faster or slower depending on volume of requests received.
How do I submit a Toll Free Verification Request
You can do so by:
Telnyx Portal: portal.telnyx.com > Real Time Communications > Messaging > Compliance > Toll Free Verification > Submit Verification Request
Telnyx API: Submit Verification Request
Once you have submitted the Toll Free Verification Statuses are:
Waiting for Telnyx - We review all submissions to determine if the traffic should be allowed on the platform and for compliance requirements.
Waiting for Customer - If the Telnyx review team has a change we would like you to make to your Verification Request then we will change the status to Waiting for Customer and the decline reason will have what steps we would like you to take.
Waiting for Vendor - Once Telnyx team approves the VR it goes to the carriers to get the final approval.
Rejected - If the carriers or Telnyx team reject the VR then the status will be rejected and the decline reason will have why it was rejected.
Verified - Once the Telnyx team and carriers have approved it, then the status will be "Verified" and you can begin sending outbound text messages from the toll free number.
It is important to know that you if you submit a new Verification Request for an already approved Toll Free number it will be overwritten and become unverified until the new Verification Request is approved.
Toll-Free Verification Form Explanation
1. Business Identification
Business Name
Corporate Website: Please include a business website or social media page for the business.
Email Address: The website domain should match the domain of the email address provided.
Business Address- Valid business address
Contact Number: Contact number for the business using the Toll Free number (not the toll free number being reviewed for this Verification Request).
Business Contact: a common occurrence is business names/departments in those fields when it needs to be a persons first/last name
2. Messaging Details
Expected Message Volume- Approximate based on the available drop down options.
Use Case : This refers to the specific purpose for which the business intends to use toll-free messaging. Examples include conversational, marketing, transactional notifications, or fraud alerts. If you use a mixed use case then please describe the actual use cases in the Use Case description field. Every sms use case mentioned on the opt in form should be present here in some way.
Description of the Use Case / Summary : This section provides more details about how the business will use the toll-free number for messaging. It should explain the types of messages being sent, the intended audience, and any relevant compliance measures. This additional information helps verification teams assess whether the use case is legitimate and compliant with messaging policies. If you use a mixed use case then please describe the actual use cases in the Use Case description field. For mixed use cases every sms use case mentioned on the opt in form should be present here in some way.
Message content: Please add samples for each use case you selected and described in the use case summary field.
3. Opt in Workflow Description / Opt-in Image URL: Provide a link, a link to an image, or a link to a scanned copy of the opt-in.
Ensuring proper SMS consent is critical for verification. The opt-in process must be clearly documented in the Workflow Description explaining how the opt in process works. For example you could say subscribers opt in on my website at https://exampleurl.com/opt-in. There are 4 ways users can opt in to receive sms:
1) Digital
2) Paper
3) Verbal
4) Inbound Message
For a digital opt in you need to include the url or link to a screenshot of the opt in form and how subscribers reach it.
For a paper opt in you need to include a link to the uploaded file and how subscribers receive it.
For a verbal opt in you need to include the script users hear when opting in and how they receive it and where for instance if it over the phone then what number do they call. If it is in person then how do they learn the address.
For an inbound message please give the phone number they text into and how they learn it.
If you do not have a link for the opt in image url field, like for a verbal consent opt in, then put a link to a publicly accessible google doc or dropbox file which diagrams how the opt in process works.
If Marketing is a selected use case then on the opt in, marketing sms opt in must have its own compliant checkbox separate from the other use cases.
Opt-in Form:
[Checkbox 1] By checking this box and submitting this form, you consent to receive transactional text messages for [use case(s)] from (Company Name). Reply STOP to opt out. Reply HELP for help. Standard message and data rates may apply. Message frequency may vary. View our Terms and Condition [hyperlink]. View our Privacy Policy [hyperlinked].
[Checkbox 2] By checking this box and submitting this form, you consent to receive text messages for marketing from (Company Name). Reply STOP to opt out. Reply HELP for help. Message and data rates may apply. Message frequency may vary. View our Terms and Condition [hyperlink]. View our Privacy Policy [hyperlinked].
Note: In the privacy policy the carriers typically require verbaige to the effect of "We will not share or sell your mobile information with third parties for promotional or marketing purposes."Note: Checkboxes must be optional and cannot be pre-checked.
Important Note:
The business name should be included on the opt in form within the message content to make sure the consumer knows who they are interacting with.
The SMS opt-in checkbox should be unchecked by default.
SMS consent should be separate from other communication consents (e.g., email). This means having distinct checkboxes for SMS and email opt-in.
Previously, the opt-in message and privacy policy were combined into a single checkbox for consent. Now, accepting SMS opt-in and privacy policy must have separate checkboxes.
4. ISV/Reseller Information
ISV/Reseller: If the Telnyx account username domain does not match the domain for the business website and business email address in the business contact section of the Toll Free Verification Request then it will be put into a Waiting For Customer status until the Reseller field has been accurately filled out with the Reseller name.
5. Additional Supporting Details
If you are submitting multiple Toll Free Numbers in a single Verification Request then please include a valid explanation for why multiple numbers are needed, and there will be a special review.
Also, if there are any other details you would like Telnyx or the carriers to know you can include that here!
Toll Free Error Codes:
Reason | Eligibility for Resubmission |
No Reason Provided | Not Eligible |
Content Violation - SHAFT (Sex, Hate, Alcohol, Firearms, Tobacco/Vape, Marijuana/CBD) | Not Eligible |
Campaign Violation - Age Gate Not Present / Not Acceptable | Eligible with Robust Age Gate Implemented |
Known Spam Campaign | Not Eligible |
Disallowed Content - Loan Marketing, 3rd Party Debt Collection, Gambling, Sweepstakes, Stock Alerts, Cryptocurrency, Risk Investment, Debt Reduction, Credit Repair, 3rd Party Lead Generation, Federally Illegal Substances | Not Eligible |
Known Phishing Campaign | Not Eligible |
High Risk - Fraud | Not Eligible |
High Risk - Deceptive Marketing | Not Eligible |
High Risk - Public URL Shortener | Eligible if changed to a branded URL domain |
High Risk - Non-secured URL | Eligible if corrected to HTTPS |
Invalid Information - Can't Verify Business Information | Eligible if business details are corrected |
Invalid Information - Can't Validate URL (Website inaccessible) | Eligible if website access is restored |
Invalid Information - ISV Contact Provided Instead of End User | Eligible if corrected |
Opt-in - Not sufficient for campaign type (Express Consent Required) | Eligible if express consent is provided |
Opt-in - Consent for messaging is a requirement for service | Eligible if consent is documented |
Opt-in - No opt-in provided | Eligible if opt-in is provided |
Opt-in - Shared with 3rd Parties | Eligible if language is updated to remove 3rd-party sharing |
Campaign Violation - Single Number Used for Multiple Businesses | Eligible if each business is assigned a unique toll-free number |
Opt-in - List Opt-in Relies on Organizational/Government Exemption | Not Eligible |
Additional Information Requested - Justification for more than 5 numbers per business | Eligible if justification is provided |
Additional Information Requested - Opt-in Information Not Provided | Eligible if updated |
Additional Information Requested - Business Information Not Valid | Eligible if corrected |
Submission Editing Timed Out | You have 7 days from when it is submitted to the carriers for Telnyx to resubmit without any changes. This is not a big problem for portal users because if you make a small change to your existing Verification Request and hit save then it creates a new VR Id without you having to fill it out from scratch. More of a challenge for API users to address. |
Number Not Provisioned to Your Organization | Not Eligible |