Twilio Toll Free Verification Process and Troubleshooting

To get your Twilio toll-free number up and running, you'll need to go through the verification process. This typically involves providing documentation to prove your business identity, such as an EIN or business license.

The verification process can take some time, so plan accordingly. The exact timeframe will depend on the complexity of your application and the speed at which you can provide the required documentation.

To speed up the process, make sure you have all necessary documents ready to go before submitting your application. This will help prevent delays and get your toll-free number activated faster.

You might like: Twilio Application

To complete toll-free verification, you need a few things in place. First and foremost, you need a paid Twilio account, which isn't something you can do in trial mode.

A paid Twilio account is necessary, and you can find more information on how to upgrade to a paid account in the Upgrading to a Paid Twilio Account support article.

Intriguing read: Account Verification

You'll also need a Twilio toll-free number, which you can purchase by following the link to learn more.

Here are the specific requirements you need to meet:

Once you have these prerequisites covered, you can move on to adding your business and contact information.

To submit a toll-free verification (TFV) request, you need to go to the Active Numbers page in the Console and click on the phone number. Then, navigate to the Regulatory Information tab and click Verify this toll-free number.

The verification process differs depending on whether you have existing Customer Profiles. If you have an approved Primary Customer Profile, your request only needs the parameters for the TFV. You can learn more about the required information for toll-free verification in the Twilio Help Center.

If Twilio rejects your TFV request, the toll-free number won't be verified and you can't use it to send messages. You can review common rejection reasons in the Twilio Help Center and resubmit your request if it's eligible for resubmission.

Take a look at this: Twitter Verification

To create a TFV request, you'll need to submit a verification request for the related business. This is a straightforward process that requires some specific information.

For NANP toll-free phone numbers, you'll need to submit a verification request with the required parameters for the TFV. You can find more information on the required information on the Twilio Help Center.

If you're an ISV submitting verification requests on behalf of multiple customers, or if you're submitting requests for multiple toll-free numbers, consider using Twilio's Event Streams product to subscribe to events related to your toll-free verification requests.

Here are the steps to submit a TFV request:

By following these steps, you'll be able to create a TFV request and get the verification process started.

If Twilio rejected your TFV request, your check request displays "status": "TWILIO_REJECTED". You can't use the toll-free number to send messages until it's verified.

To review common rejection reasons, see Why Was My Toll-Free Verification Rejected? in the Twilio Help Center.

Here's an interesting read: Toll (telecommunications)

If the response includes "edit_allowed": true, you can resubmit your TFV request.

Click on the number in the Active numbers section of the Console to see the rejection reason for a number.

If the number is eligible for resubmission, you will see a Make corrections and resubmit button. You can resubmit your verification request within the specified window to go into a priority queue for review.

You have a limited time to resubmit, with the number of days left displayed next to the Make corrections and resubmit button.

Click the Make corrections and resubmit button to see the reason your verification was rejected and correct the information. At the bottom of the window, you must agree to the Terms of Service before resubmitting.

If the number is not eligible for resubmission, you will see a button that says Review rejection details.

Intriguing read: Verify Phone Number Twilio

To review the verification status of your Twilio toll-free number, go to the Twilio Console and navigate to Phone Numbers > Manage > Active numbers. Select the toll-free phone number you want to review and click on the Regulatory Information tab.

Consider reading: Twilio Virtual Phone Number

You can find the possible verification statuses for a toll-free number in the following table:

You can delete your toll-free verification requests directly from the Console if they are Pending, Approved, or Rejected.

If you're experiencing issues with Twilio Toll Free Verification, start by checking the status of your verification request, which can be found in the Twilio Console under the "Verification" section.

Verify that you have a valid phone number and account credentials, as incorrect information can cause verification failures. Make sure your phone number is not blocked or suspended by Twilio.

If you're still having trouble, review the error messages generated by the Twilio API, which can provide valuable insights into the cause of the issue.

See what others are reading: Verify Twilio Number for Dev

If your toll-free verification was rejected, it's likely due to a lack of express consent from consumers. This means you didn't get voluntary, informed end-user choice for a specific purpose, which requires upfront disclosure and intentional action.

A fresh viewpoint: Twilio - Sms/mms-svr

Express Consent is more than just collecting a phone number; it's a clear understanding of why the customer gave the number and how they expect the company to communicate with them.

You might have listed "SMS" in your Terms of Service or Privacy Policy, but that's not enough to get Express Consent. Written permission is required, and it must be specific to marketing messages.

To get Express Consent, you need to obtain a consumer's consent to receive messages generally, and their express written consent to receive marketing messages specifically. You should also ensure consumers can revoke consent at any time.

Here's a quick rundown of what you need to do:

If you've made major changes to your messaging use case or opt-in flow, you might need to delete and resubmit your verification request. However, if a previous submission was eligible for resubmission, use the resubmit flow instead of deleting and recreating a new request.

Consider reading: How to Use Twilio

If Twilio rejected your Toll-Free Verification (TFV) request, your check request displays "status": "TWILIO_REJECTED". The toll-free number isn't verified and you can't use it to send messages.

To review common rejection reasons, see Why Was My Toll-Free Verification Rejected? in the Twilio Help Center. This resource provides information on possible causes, including insufficient opt-in workflow and the need for express consent.

If the response includes "edit_allowed": true, you can resubmit your TFV request. Otherwise, you'll need to delete the failed request.

To delete a failed TFV request, you'll need the SID for the Verification record to delete. This SID starts with HH followed by 32 other hexadecimal digits. If you don't have your TFV request SID, use the API to get a list of TFV SIDs for your related toll-free number.

For another approach, see: Twilio Account Sid

To support changes to toll-free messaging policy when submitting a TFV request, include additional metadata about your business.

Providing this information before it's required can help avoid rejection and accelerate vetting.

To learn more, see Toll-Free Verification Policy for Collecting Business Registration Number in the Twilio Help Center.

Business registration information is a crucial part of the process.

The fields for business registration include data that verifies your business's legitimacy.

Business metadata and classification is another key area to focus on.

This includes information that helps Twilio understand your business's operations and structure.

Opt-In and messaging compliance are also essential for a smooth TFV process.

Make sure you have all the necessary information and documentation to avoid delays.

Worth a look: Twilio's Whatsapp Business Api Page.

Twilio provides excellent resources for developers to get started with their toll-free verification, and one of the best places to begin is with their Docs.

API reference documentation is available to help you understand how to use Twilio's services, including toll-free verification.

Twilio's Docs also offer SDKs, which are pre-built software development kits that make it easier to integrate Twilio's services into your application.

Helper libraries are another valuable resource provided by Twilio, offering pre-written code that can be used to simplify the development process.

Quickstarts are available to help you get up and running with Twilio's services as quickly as possible, with step-by-step guides and examples to follow.

Tutorials are also included in Twilio's Docs, providing in-depth guides and examples to help you learn how to use Twilio's services, including toll-free verification.

Take a look at this: Texting App That Receives Verification Codes