Toll-Free Verification New Policy API Onboarding Guide Preview
This guide is intended for developers and businesses using the Twilio API to submit Toll-Free Verification requests. It covers the new optional and upcoming required fields introduced as part of the latest Toll-Free Verification Policy changes. After reading this document, you will be able to submit verification requests using these new fields to ensure compliance and reduce the chance of rejections.
To support the upcoming changes to the Toll-Free Verification Policy, Twilio is introducing several new parameters to strengthen business verification and compliance. These fields are currently optional, but some will become required by January 2026.
Warning
This is a preview; fields may change before the official launch. These fields are supported in both Console and API submissions. Including them does not affect current processing time but can reduce the chance of rejections.
These fields help validate the legal identity of the business submitting the request.
| Parameter | Field Type | Description |
|---|---|---|
BusinessRegistrationNumber | String | The official business registration number (e.g., Employer Identification Number (EIN) in the U.S.). Required for all new TFV submissions starting January 2026. |
BusinessRegistrationType | String | The type of business registration being provided (e.g., EIN, Canada Revenue Agency (CRA), Companies House). |
BusinessRegistrationCountry | String | The ISO 3166-1 alpha-2 country code of the issuing business authority. |
Info
U.S.-based organizations should provide their Employer Identification Number (EIN). For businesses outside the U.S., provide the local or national registration number and issuing country. If you do not have an EIN, EntityType should be set to SOLE_PROPRIETOR.
The following fields are optional today, but some may be required in the future. Including them now can provide more complete context for vetting and support faster reviews.
| Parameter | Field Type | Description |
|---|---|---|
DoingBusinessAs | String | Doing Business As (DBA) name of the business, if different from the legal name. |
BusinessContactPosition | String | Title or role of the business's primary contact. |
PrimaryIndustrySector | String | The industry sector in which the business operates. |
EntityType | Enum | The business entity classification. Accepted values: SOLE_PROPRIETOR, PRIVATE_PROFIT, PUBLIC_PROFIT, NON_PROFIT, GOVERNMENT. |
OptInConfirmationResponse | String | Message sent to users confirming their opt-in to receive messages. |
HelpMessageResponse | String | The message returned when users text "HELP". |
PrivacyPolicyURL | String | URL pointing to the business's privacy policy. |
TermsAndConditionURL | String | URL pointing to the business's terms and conditions. |
AgeGatedContent | Boolean | Indicates if messaging content requires age gating (e.g., 18+). Accepted values: true, false. Default is false. |
OptInKeywords | String | Keywords used to collect and process consumer opt-ins. |
The following example demonstrates how to submit a Toll-Free Verification request with the new optional parameters introduced as part of this policy change.
Request:
1curl -X POST "https://messaging.twilio.com/v1/Tollfree/Verifications" \2--data-urlencode "BusinessName=Owl, Inc." \3--data-urlencode "BusinessStreetAddress=123 Main Street" \4--data-urlencode "BusinessStreetAddress2=Suite 101" \5--data-urlencode "BusinessCity=Anytown" \6--data-urlencode "BusinessStateProvinceRegion=AA" \7--data-urlencode "BusinessPostalCode=11111" \8--data-urlencode "BusinessCountry=US" \9--data-urlencode "BusinessWebsite=http://www.example.com" \10--data-urlencode "BusinessContactFirstName=firstname" \11--data-urlencode "BusinessContactLastName=lastname" \12--data-urlencode "BusinessContactEmail=email@example.com" \13--data-urlencode "BusinessContactPhone=+1231231234" \14--data-urlencode "NotificationEmail=support@example.com" \15--data-urlencode "UseCaseCategories=TWO_FACTOR_AUTHENTICATION" \16--data-urlencode "UseCaseCategories=MARKETING" \17--data-urlencode "UseCaseSummary=This number is used to send out promotional offers and coupons to the customers of John's Coffee Shop" \18--data-urlencode "ProductionMessageSample=lorem ipsum" \19--data-urlencode "OptInImageUrls=https://example.com/images/image1.jpg" \20--data-urlencode "OptInImageUrls=https://example.com/images/image2.jpg" \21--data-urlencode "OptInType=VERBAL" \22--data-urlencode "MessageVolume=10" \23--data-urlencode "AdditionalInformation=see our privacy policy here www.example.com/privacypolicy" \24--data-urlencode "TollfreePhoneNumberSid=PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \25--data-urlencode "ExternalReferenceId=abc123xyz567" \26--data-urlencode "BusinessRegistrationNumber=123456789" \27--data-urlencode "BusinessRegistrationType=EIN" \28--data-urlencode "BusinessRegistrationCountry=US" \29--data-urlencode "DoingBusinessAs=Other Company" \30--data-urlencode "BusinessContactPosition=Owner" \31--data-urlencode "PrimaryIndustrySector=Retail" \32--data-urlencode "EntityType=PRIVATE_PROFIT" \33--data-urlencode "OptInConfirmationResponse=Opt in sample" \34--data-urlencode "HelpMessageResponse=Help sample" \35--data-urlencode "PrivacyPolicyURL=http://www.example.com/privacy" \36--data-urlencode "TermsAndConditionURL=http://www.example.com/terms" \37--data-urlencode "AgeGatedContent=false" \38--data-urlencode "OptInKeywords=STOP" \39-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN