Skip to contentSkip to navigationSkip to topbar
On this page

Toll-Free Verification Console Onboarding Guide


Twilio toll-free numbers cannot send SMS messages to the United States and Canada until toll-free verification is completed and approved. This document covers how you can submit your toll-free phone number for messaging verification directly from the Twilio Console and review the verification status for any of the toll-free numbers in your Twilio Account.

See this support article(link takes you to an external page) for more information about toll-free verification requirements.


Prerequisites

prerequisites page anchor

To complete toll-free verification, you need:


Submit information for verification

submit-information-for-verification page anchor

Go to the Active Numbers page in the Console(link takes you to an external page). Any unverified toll-free number you own shows a warning with a link to the verification section in the Console. To get to the verification page for a toll-free number:

  • Click on the phone number.
  • Navigate to the Regulatory Information tab.
  • Click Verify this toll free number .

The verification process differs depending on whether you have existing Customers Profiles. See below for how to verify your number with an existing Customer Profile, or how to create a new Customer Profile and verify your number.

Verify with an existing Customer Profile

verify-with-an-existing-customer-profile page anchor

In this case, you have at least one Customer Profile for your business. Select the profile you'd like to use and review the business information. Confirm the "Legal entity name" and "Website URL".

Choose an existing Customer Profile for toll-free verification in the Twilio Console.

Then, complete the information for your Messaging Use Case and submit the information for verification.

Complete your use case and opt-in flow for toll-free verification in the Twilio Console.

A confirmation message appears after you complete and submit the information.

Verify with a new Customer Profile

verify-with-a-new-customer-profile page anchor
(warning)

Warning

If you are an ISV, make sure that your Primary Business Profile is approved before submitting toll-free verification requests for your secondary customers.

In this case, you have not created a Customer Profile before.

First, add your business and contact information (Step 1), then your business location (Step 2).

Business and Contact Information page.
Business Location page.

This automatically creates a Customer Profile for you. Next, complete the information for the Messaging Use Case and submit the information for verification.

Complete your use case and opt-in flow for toll-free verification in the Twilio Console.

A confirmation message appears after you complete and submit the information.


Review verification status

review-verification-status page anchor

To review the verification status of any Twilio toll-free number, go to the Twilio Console and navigate to Phone Numbers > Manage > Active numbers(link takes you to an external page). Once there, select the toll-free phone number that you would like to review and click on the Regulatory Information.

Below are the possible verification statuses for a toll-free number:

Submission StatusWhat's happeningToll-Free phone number traffic
Not verifiedTwilio's systems are processing the request. Verification Ops has not yet received it for review.The toll-free phone number is Restricted.
Verification in progressVerification Ops have accepted the submission and it is in their queue.The toll-free phone number is Pending.
ApprovedVerification Ops approved the submission.The toll-free phone number is Verified.
RejectedVerification Ops rejected the submission. If the submission is re-submittable, you have seven days to resubmit it for priority review. After seven days, the toll-free phone number remains Restricted until you resubmit verification. See Why Was My Toll-Free Verification Rejected?(link takes you to an external page) for more information about rejection reasons and what to do.If re-submittable, the toll-free phone number is Pending. If not re-submittable, the toll-free phone number is Blocked. If seven days have passed since the rejection, the toll-free phone number is Restricted.

Please see Toll-Free Message Verification for US/Canada(link takes you to an external page) for more information.

(warning)

Warning

If you are an ISV submitting verification requests on behalf of multiple customers, or if you are submitting verification requests for multiple toll-free numbers on your own behalf, consider using Twilio's Event Streams product to subscribe to events related to your toll-free verification requests. See the Toll-Free Verification API reference for more information. Subscribing to Event Streams doesn't require API calls.


Edit and resubmit a rejected toll-free verification

edit-and-resubmit-a-rejected-toll-free-verification page anchor

You can submit a rejected toll-free verification if it is eligible for resubmission.

To see the rejection reason for a number and to see if you can resubmit it, click on the number in the Active numbers(link takes you to an external page) section of the Console. Then, click on the Regulatory Information tab.

If the number is eligible for resubmission, you will see a Make corrections and resubmit button, with a message that tells you the number of days you have left to resubmit (for example, "6 days left"). If you resubmit your verification request within this window, your request will go into a priority queue for review. You can still submit outside of this window, but the resubmission will go into the same queue as new toll-free verification requests.

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 and then you can click Send Information for verification.

If the number is not eligible for resubmission, you will see a button that says Review rejection details. See Why Was My Toll-Free Verification Rejected?(link takes you to an external page) for more information about rejection reasons and how to fix them.

For additional information about rejections that are ineligible for resubmission, refer to the following articles:


Delete a toll-free verification

delete-a-toll-free-verification page anchor

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

To delete the verification, go to Phone Numbers > Manage > Active numbers(link takes you to an external page) in the Console and select the toll-free phone number. Then, navigate to the Regulatory Information tab and click Delete verification. Confirm that you want to delete the toll-free verification. This is a destructive action and it can't be undone.

(information)

Info

Deleting a toll-free messaging verification request does not release the toll-free number from your Twilio Account.

See below for information about when you can and cannot use this delete feature:

(warning)

Warning

Deleting and resubmitting a verification request puts the new verification request in the back of the review queue. Only delete your verification request if you need to make major changes to your messaging use case or opt-in flow. If a previous submission was eligible for resubmission, use the resubmit flow rather than deleting and recreating a verification request.

Verification StatusAction
Restricted (Not verified)Deletion is not available.
Verification in progressDelete this verification request to stop this verification and submit a new one. Do this if you need to correct information about the messaging use case, opt-in flow, or business information such as a website URL. Other issues should not impede verification and do not require deletion and resubmission.
ApprovedDelete an approved verification request if you want to change the messaging use case and/or opt-in flow for that verified toll-free number. Then resubmit the verification for the number with the new information. No deletion and resubmission is required if you're only making minor changes to your use of the toll-free number for messaging, such as the message content.
RejectedIf a previous submission was rejected with the note "not eligible for resubmission", deleting that verification request is the only way to resubmit the same toll-free number for verification. Only do so if you have a clear understanding of what you need to correct (for example, a mistyped or incorrect website URL, or an incomplete use case or opt-in description). See Why Was My Toll-Free Verification Rejected?(link takes you to an external page) for more information about rejection reasons and how to fix them.

Need some help?

Terms of service

Copyright © 2024 Twilio Inc.