Vonage Self-Serve Toll-Free Number Registration Guide

Introduction

A Toll-Free Number (TFN) is a 10-digit phone number that can be dialed at no charge by the person placing the call, while the recipient bears the charges. For SMS and MMS, message and data rates may apply, and each TFN begins with a distinguishing prefix such as 800, 888, 877, 866, 855, 844, or 833. 

Vonage offers TFN voice services in approximately 140 countries. However, only the U.S. and Canada offer TFN voice with “text and picture messaging” capabilities. 

Registration of TFNs in the US and Canada is required by the wireless carriers (operators) for commercial SMS and MMS messaging without sender limits. 

Vonage Toll-Free Number Self-Serve Registration offers the ability to:

✅ Register Toll-Free Numbers in a streamlined, step-by-step flow

✅ Track registration status and approvals in real time

✅ Manage SMS & MMS compliance requirements with ease

✅ Gain greater visibility and transparency into your TFN messaging

✅ Add up to five (5) Toll-Free Numbers within a single registration

✅ Easily manage high volumes of registrations with Toll-Free Number Registration APIs
 

If you have any issues with the Portal or APIs, or would like to share any thoughts or feedback, please contact our Support Team.

Content

• High-Level Process Steps
• Step-by-Step Toll-Free Number Registration Process
• Toll-Free Number Registration APIs
• Frequently Asked Questions (FAQ)

High-Level Process Steps

1. Login to the Vonage API Dashboard and under the Phone Numbers tab, select the Toll-Free Number Registration tab on the left-hand bar to access the Toll-Free Number Registration page.
2. If you have not purchased a US Toll-Free Number, you will be asked to navigate to Buy Number to buy/purchase a US Toll-Free Number. Note: US TFNs offer coverage in both the US and Canada.
3. Go to Toll-Free Number Registration and click on Register to access the TFN registration form.
4. Follow the three screens (steps) to complete the Toll-Free Number Registration form request.
   1. The Business Profile screen includes fields related to the business/content provider.
   2. The Toll-Free Number Information screen includes fields related to the messaging campaign.
   3. Review the confirmation screen
   4. Agree to Vonage Terms and submit.
5. Once your request is submitted, a confirmation message is displayed.
6. Navigate back to the Toll-Free Number Registration screen to track the status of your request.

Step-by-Step Toll-Free Number Registration Process

STEP 1a: Navigate to the Vonage API Dashboard Portal

Login to the Vonage API Dashboard and under the Phone Numbers tab, select the Toll-Free Number Registration tab on the left-hand bar to access the Toll-Free Number dashboard.



STEP 1b: Navigate to the Vonage API Dashboard Portal

If you have not purchased a US Toll-Free number, you will be asked to navigate to Buy Numbers to buy/purchase a US Toll-Free Number (BUILD -> Phone Numbers -> Buy Numbers -> Select Country “United States”, Type “Toll-Free”). 

• Click “Buy” to complete the Toll-Free Number purchase.
• Click “Buy & Register Now” to purchase a Toll-Free Number and get redirected to the Registration Form to activate mobile messaging service. 
  
  
  
  

STEP 2: Access the TFN Registration Dashboard

Purchased numbers will appear under the Phone Numbers tab. Click on Toll-Free Number Registration on the left-hand bar to access the TFN Registration dashboard.

STEP 3: Start a New TFN Registration Request

All newly purchased TFNs are in “Not Registered” status. Click on 'Register' to access the TFN registration form. 

1. Business information
   
   
2. Toll-Free Number information
   
   

STEP 4: Complete the Registration Request Form

It’s as easy as 1-2-3!  Follow the three screens to complete the TFN registration request form. 

• Note, TFN registration doesn't guarantee messaging service activation or deliverability, as new requests are initially vetted for accurate program information and the system subjects traffic to content filtering.

Screen 1: Business Profile

Populate all the mandatory fields as requested.

• Organization Name
  • The actual content provider (end-customer), not an ISV or reseller.
• Organization Address
  • The registered address, city, state/province/region, and zip/postal code.
• Organization Website
  • The content provider's URL (end-customer, not reseller). Should be an active site with security (https), and links to the SMS Terms and Privacy Policy pages.
    • SMS Terms should mention that the user opts in to receive mobile messages and include the message content type. May include disclosures such as "Message and data rates may apply" pricing disclosure, "Message frequency varies" (or "One message per request") frequency disclosure and "Text HELP for info, STOP to cancel" keyword support.
    • Privacy Policy should not share SMS data commercially with third parties for marketing purposes. If so, in order to get activated, then the following text may be added to the site’s respective section "All the above categories exclude text messaging originator opt-in data and consent; this information will not be shared with any third parties." Note, this refers to any section in the policy that sells, shares, rents, leases, or buys SMS information commercially with third parties for advertising, marketing, or promotional purposes.
• Organization Contact
  • The content provider (end-customer) contact's first and last name, phone number, and email address. Best if the email domain matches the website URL and company/brand name. An exception permits smaller organizations to register using Gmail, Yahoo, and Outlook email addresses.
  • The email address provided will receive confirmation and status updates related to their TFNs.
    • There are two email fields on the Toll-Free Number (TFN) registration form:
      • ISV/Reseller Contact Email: If you are a reseller, enter your email address in this field. All registration-related communications will be sent to this address.
      • Contact Email: If you are a direct customer, enter your email address in this field. All communications will be sent to this address.
    • If both fields are filled in, communications will be sent to the email address entered in the ISV/Reseller Contact Email field.

Effective February 17, 2026, the following compliance fields will be required for all new TFN registrations:

• Entity & Tax Identifier
  • Entity Type - Provide a legal classification for the organization. Options include - Sole Proprietor, Private Profit, Public Profit, Non-Profit, and Government.
  • Tax Identifier Type - Provide an appropriate tax classification. 
    • For the U.S., a Federal Tax ID or Employee Identification Number (EIN) is required.
    • For Canada, the Canada Business Number (CBN) is required.
    • For other country-specific registration, select the relevant option or Other.
  • Tax Identifier Number - Provide the corresponding number based on the Tax Identifier Type selected.

  • Tax Identifier Issuing Country - Accepts two-character ISO 3166 country codes. Example: U.S., CA, UK, etc. 

     

Screen 2: Toll-Free Number Information

Populate the mandatory fields as requested.

• Toll-Free Numbers
  • Select up to 5 Toll-Free numbers from the drop-down per submission within a single registration form. Ex: 18443659460, 18669010242.
  • If more than one number is selected, then a ‘valid business reason’ must be provided per number as part of the same registration.
• Estimated Monthly Message Volume
  • Select from drop-down options. This is not a precise forecast, but it is an approximation for planning purposes.
• Use Case Category
  • Select from drop-down options. If unable to find an appropriate industry, select "Mixed" which represents "Other".
  • Note, if “Mixed” is selected, then “two” opt-in check boxes will be required, one expected for alerts or 2FA/OTP and the other for marketing messages.

• Use Case Description
  • Enter a sentence describing your organization, what type of messages will be sent, who the recipients are, and how they find out about the messaging program? Ex: Restaurant collects a mobile number from a guest at check-in to receive a text notification when their table is ready.

• Message Content
  • Provide a sample message to be sent, up to 160 characters. Ex: "PizzaPalace: Thanks for visiting our restaurant, your table is ready."
  • One message segment contains up to 160 characters, including spaces. We process segmented (concatenated) longer messages too and suggest limiting them to five segments. The larger carriers (AT&T, T-Mobile, Verizon) receive segmented messages and reassemble them as one single message before presenting the message to the user on the handset.  Smaller carriers deliver in segments (ie: 1 of 2, 2 of 2).

• Opt-In Consent Workflow Description
  • How does the message recipient consent to receive text messages? Ex: Do they provide a mobile number online, on a mobile website, or application?  Or do they text a keyword to the number and text-to-join? Or do they verbally relay at a point of sale? Or do they ask end-users to sign up on a paper form?
  • Select one of the following options:
    • Online (website, mobile app/browser)
    • Text-To-Join
    • Point-Of-Sale
    • Other
      • If “other” is selected, a description must be provided

• Opt-In Consent Link
  • To get registered, we must demonstrate proof of opt-in consent describing how the message recipient explicitly agrees to receive text and/or picture messages.
  • Provide a link to a shared URL for opt-in. Ensure the URL is accessible publicly.
  • At a minimum, the user must be informed something like "By checking this box, you agree to receive _____ (message type, e.g. alert) mobile messages from _____ (content provider name)."
    • Opt-in for SMS/MMS must be “optional”
    • Opt-in must explicitly reference the mentioned use case
    • Brand name or logo must be shown in the opt-in (cannot be generic)

    • If both Alerts and Marketing messages, or if “Mixed”, then two opt-in check-boxes are required (see example below)

      

    • If opt-in is on paper form or verbal: A letter on company letterhead should describe the business, messaging use case, and must include a “script” being told to the individual receiving the messages.

• Additional Information
  • Provide any additional information, such as a valid business reason for multiple numbers 

Effective February 17, 2026, the following compliance field will be required for all new and existing Political TFN registrations:

• Campaign Verify (CV) Token – Required for Political use cases leveraging Campaign Verify accreditation. All political senders—including all 527 tax-exempt political organizations, both new and existing—must have a valid Campaign Verification Authorization (CV) token in place to continue sending TFN messages. Visit Campaign Verify at https://www.campaignverify.org/  to get started. 
  • To avoid any disruption, please generate and share your Campaign Verification Authorization token with Vonage no later than February 12, 2026.
    ⚠️ If the token is not received by this date, your political messaging traffic is expected to be blocked.

In addition to the required fields above, we have also added the following optional fields to support enhanced transparency and compliance:

• Age-Gated Content - If messages include content legally restricted to certain age groups over 21 years of age (e.g., alcohol, tobacco).

• Opt-In Keywords - Keywords that an end customer can text to explicitly consent to receiving messages from the Toll-Free Number (e.g., JOIN, START).

• Opt-In Confirmation Message - The first message the end user receives after opting in to the messaging campaign. Must be 160-characters or less. For example: "Brand Name: Welcome! You've signed up for <<Use Case Category>> messages. Msg freq varies. Msg&data rates may apply. Reply HELP for info, or STOP to opt-out."
• HELP Confirmation Message – After the end user texts HELP, they receive a response with support information. Must be 160-characters or less. For example: "Brand Name: Thanks for contacting us. Please visit https://www.vonage.com/support or email support@api.vonage.com."

Screen 3: Review & Confirmation

• Review all of the information provided.
• Go Back to edit any changes.
• Accept the Vonage Terms and click Submit.

STEP 5: Confirmation Message

• Once the request is submitted, a confirmation message is displayed on the page.
  
  

STEP 6: Vonage Processes the Request 

The Vonage TFN team will review the request. You can view the status of the registration request on the portal. 

STEP 7: Email Notification 

The Vonage TFN team will communicate via email (either via the contact email/reseller contact email provided on the form) with status updates. Please be on the lookout for this communication. If you need additional clarification/assistance, please reply to the email received from Vonage regarding your registration request, and our team will review it and respond. 

STEP 8: View Toll-Free Number Registration Details

After submitting/updating the TFN registration request, you can view the ticket details when you click on the number from the TFN dashboard.

STEP 9: Toll-Free Number Registration Status 

The Vonage TFN registration process provides certain statuses that are listed below:

STEP 10: Other Features 

The Vonage TFN registration tool offers more features, as listed below:

Toll-Free Number Registration APIs

Toll-Free Number registration APIs enable programmatically managing and streamlining registration flow through the following endpoints:

1. Create/Update Registration – Submit and modify a TFN registration request
2. Retrieve TFNs by Account – Query all TFNs associated with your account
3. Retrieve TFN Registration Details – Access registration details by registration ID
4. Retrieve Event Updates for TFN – Track real-time status updates and events

Developer Resources

To assist with integration, we’ve provided comprehensive documentation, including API specifications, request/response formats, and implementation guidelines, and a Toll-Free Number API Reference guide.

Key Benefits

Integrating these APIs into your workflows can enhance operational efficiency by:

• Automating manual processes and minimizing reliance on support teams
• Speeding up registration turnaround times

• Providing real-time transparency into the registration lifecycle

   

Frequently Asked Questions (FAQ)

What is a Toll-Free Number?

Toll-Free Number (TFN) is a 10-digit phone number that can be dialed at no charge by the person placing the call, it is however, the recipient who bears the charges. Each TFN begins with a three-digit code that distinguishes it as a toll-free number such as 800, 888, 877, 866, 855, 844, and 833.  TFNs can also send and receive text and picture messages in the US and Canada.

What is new?

You can now submit new single-form Toll-Free Number (TFN) registration requests via the Vonage API Dashboard. Submissions will be sent to the Vonage team for review, and any follow-up, status, or further clarifications will be handled via email. 

What is changing?

Customers who have been submitting their TFN registration request via Google Form or Bulk CSV file can now use the Vonage API Dashboard or APIs to submit their single-form registration requests and track their status going forward.

Why are we doing this?

Vonage provides this self-serve portal for customers to register their TFNs in an efficient and systematic way. The increase in spam and fraudulent activities via SMS has prompted companies and carriers to take measures to safeguard their customers.  Registration of TFNs enables companies to ensure the legitimacy and deliverability of the messages by bypassing filters and restrictions added by carriers. 

Why are some TFN registration data redacted?

We have identified incomplete or missing information in some registrations. For privacy purposes, we are currently reviewing the data to ensure alignment with our and the carrier systems. During this review period, access to certain data may be temporarily limited. 

You can use the re-register feature to register the TFN again. 

Can I submit requests for multiple Toll-Free Numbers at the same time?

Yes, you can submit up to five toll-free numbers in one submission. Note that the program details will remain the same for all five numbers submitted for registration, but the ‘valid business reason’ must be unique per number. 

Which Toll-Free Numbers must be registered?

All TFNs in your account that will be used to send SMS/MMS messages to customers in the US and Canada must be registered before sending messages. Only TFNs used for voice calls do not require registration.

What happens to registration requests submitted via the Google form or bulk sheet after the site’s availability?

TFN requests submitted via Google Form or the bulk sheet will show as Not Registered until they have reached Carrier Review. The final status will also be updated after it has been successfully registered or if it has been rejected or blocked. 
 

What happens if Toll-Free Numbers used for SMS are not registered?

All unregistered TFNs that have not completed the registration process will have their  SMS/MMS messages blocked by the carriers.

• ISV/Reseller Contact Email: If you are a reseller, enter your email address in this field. All registration-related communications will be sent to this address.
• Contact Email: If you are a direct customer, enter your email address in this field. All communications will be sent to this address.

Is there a charge to register Toll-Free Numbers?

No. 

If a Toll-Free Number is registered, can carriers still block SMS communications?

Yes, messages that contain any of the following (and not limited to the following) content can get blocked even if registered:

• High-Risk Financial Services • Payday Loans • Short Term-High Interest Loans • Auto Loans • Mortgage Loans • Student Loans • Credit Payments • Credit Repair • Debt Collection • Debt Consolidation • Debt Reduction • Debt Relief • Debt Forgiveness • Tax Relief • Affiliate Lead or Commission Generation • Gambling • Sweepstakes • Stock Alerts • CryptoCurrency
• Get Rich Quick Schemes • Deceptive Work from Home Programs • Risky Investment Opportunities • Multi-Level Marketing • Deceptive Marketing
• 3rd Party • Third-Party Brokers (Loans, Insurance, Jobs) • Debt Related • Credit Related • Lead Generation
• Controlled Substances • Tobacco • Vaping/Vapes/Vape • Illegal Drugs • Cannabis/CBD
• SHAFT • Sex (Adult), Hate Speech, Alcohol, Firearms, Tobacco • Profanity

You will be notified by the Vonage Admin team of the blocked reason.

How do I register a Toll-Free Number to enable messaging?

Refer to the steps mentioned in the Toll-Free Number Registration Guide document to create a request. Login to the Vonage API Dashboard and proceed with the registration. 

How do I track the progress of my Toll-Free registration request?

You can view the status of your Toll-Free Number Registration requests under Phone Numbers in the Vonage API Dashboard. You will be notified via email when the status changes.

Why has my Toll-Free registration request been rejected?

If your Toll-Free registration request form lacks the required information or contains illegal content, the Carrier may reject the request. You will be notified by the Vonage Admin team about the rejection reason. 

What does the Duplicate feature do?

The duplicate feature against a Registered TFN copies over the content of the registration, except for the TFN and Opt-in information. 

Are APIs available for integrating with the TFN registration service?

Yes, Public APIs were launched on the 30th March 2026. Please refer to the Developer Documentation for details. 

Who do I reach out to if I am having issues with my Toll-Free registration request?

You can reach out to support by either clicking on Support on the Vonage API Dashboard or by signing into the Support Help Center, or sending an email.  

1. Login to the API Dashboard
2. Choose “Support” from the menu on the left side
   
   

Signing in from the Support Help Center 

Choose “Continue with Vonage SSO”

Login to API Dashboard using your API Dashboard credentials