Unverified toll-free numbers cannot send SMS to the US or Canada; "not eligible for resubmission" rejections can only be retried by deleting the verification. [1]
Guides · messaging · Verification-gated
Twilio toll-free verification (US/Canada SMS)
Verify a US/Canada toll-free number so it can send SMS. Unverified toll-free numbers are blocked from sending; Twilio reviews the business, use case and opt-in proof.
Researched · not yet run liveLast researched 25 October 2026 · Twilio · provider site
Researched, not yet run live. Built from the provider’s official pages (linked below). A person hasn’t walked this flow end to end yet, so check each step against the source.
Who owns what
Each toll-free number in a paid Twilio account gets its own verification request (HH… SID), linked to a Trust Hub customer profile (BU…) describing the business. ISVs can link profiles to subaccounts per customer.
- Twilio account (paid) organisation
- Trust Hub Primary Customer Profile (BU…) organisation · under Twilio account (paid)Set up before buying the toll-free number.
- Toll-free number (PN…) other · under Twilio account (paid)
Have ready
- twilio/account-and-keys: Trial accounts cannot complete toll-free verification.
- Business registration number (US EIN), issuing authority and country, exactly as registered · Required for all business types except sole proprietor. [2]Needed for: Submit the toll-free verification
- Live business website matching the business name · Business website is a required field and is checked by reviewers. [2]Needed for: Submit the toll-free verification
- Public privacy policy URL and Terms of Service URL with SMS disclosures (message rates, frequency, opt-out) · Missing or incomplete Terms of Service is rejected with error 30493. [4]Needed for: Submit the toll-free verification
- Screenshots of the opt-in flow hosted at public URLs, with a separate consent checkbox or action · Opt-in image URLs are required, and bundled consent is rejected (error 30475). [5]Needed for: Submit the toll-free verification
- A real sample production message and the confirmation message (business name, help, STOP, rates) · Required field; incomplete confirmation messages are rejected (error 30503). [8]Needed for: Submit the toll-free verification
- Name, email and phone of an authorised business representative (a real person, not "Admin") · Generic roles are rejected (error 30483). [7]Needed for: Submit the toll-free verification
Steps
Steps marked “human step” are ones only you can do: verapli never signs in, submits, pays or accepts terms for you.
Use an upgraded Twilio account
Sign in to a paid Twilio account.
Create a Trust Hub customer profile
Create the Primary (or Secondary) Compliance Profile in Trust Hub describing your business, before buying the number.
Where: https://console.twilio.com/
Buy a toll-free number
Buy a toll-free number, choosing Business / Nonprofit / Sole Proprietor. Twilio charges the full monthly price on purchase.
Submit the toll-free verification
Fill business and contact details, address, use case, message samples, volume, opt-in type and screenshots, privacy and terms URLs, and accept the terms. You press submit.
Wait for Twilio review
Status moves from Not verified (Restricted) to Verification in progress (Pending) to Approved (Verified) or Rejected.
- The provider says
- Twilio reviews TFV requests within three business days. [3]
- People report
- Some third-party vendors report much longer waits because of carrier backlog. [9]
If something goes wrong (6)
- Rejected for Terms of Service URL (
30493): Publish a public Terms page covering message rates, frequency and opt-out, check it loads logged out, then resubmit. [4] - Rejected because consent is bundled with other terms (
30475): Add a standalone, optional messaging consent action, capture new screenshots, and resubmit. [5] - Rejected for incomplete confirmation message (
30503): Add business name, customer care contact, opt-out instructions and pricing statement to the confirmation message. [8] - Rejected because a generic contact role was entered (
30483): Enter the name and details of a real authorised representative. [7] - Rejected as fraud or deceptive messaging (
30444): If wrong, contact Twilio Support explaining the business and use case. [6] - Rejection resubmitted late: Resubmit within 7 days to keep priority; after 7 days it queues like a new request. Prefer editing over deleting, which sends it to the back of the queue. [1]
Terms and gotchas
Plain-English summary, not legal advice. Each card links its source.
The full monthly number price is charged when the number is bought, whether or not verification is approved. [1]
Consent bundled with general terms or required to use the service is rejected; opt-in must be its own action. [5]
Third-party vendors report end-to-end verification sometimes taking far longer than Twilio's three business days. [community] [9]
What you end up with
| Env var | Secret | Format | What it is |
|---|---|---|---|
TWILIO_TOLL_FREE_NUMBER | not secret | +1 8XX XXX XXXX | Verified toll-free sending number |
Pricing
- Costs: No toll-free verification fee is mentioned in Twilio's docs; you pay for the number and messages.
Source [3]
For agents
The same entry as JSON: /api/v1/entries/twilio/toll-free-verification · requirements /api/v1/requirements/twilio/toll-free-verification · terms /api/v1/terms/twilio/toll-free-verification.
Remote MCP (read-only, no auth)
claude mcp add --transport http verapli https://verapli.com/mcp
> "What do I need for Twilio toll-free verification (US/Canada SMS), and how long will it take?"
→ tools/call requirements { "provider_id": "twilio/toll-free-verification" }Sources
- Twilio docs – Toll-free verification console onboarding guide Paid account required; Trust Hub Primary or Secondary Compliance Profile before buying the number; statuses and traffic states; 7-day priority resubmission window; non-resubmittable rejections need deletion; deleting moves to back of queue; numbers cannot send to US/Canada until approved; full monthly number price charged · accessed 25 October 2026 · official
- Twilio docs – Toll-free verification API onboarding guide Required fields (business name, website, notification email, use case categories and summary, production message sample, opt-in image URLs, opt-in type, message volume, number SID); BusinessRegistrationNumber/Authority/Country required for all types except SOLE_PROPRIETOR; Customer Profile SID (BU…); review within three business days; edit before edit_expiration (7 days) · accessed 25 October 2026 · official
- Twilio docs – Toll-free verification overview Twilio reviews TFV requests within three business days; PrivacyPolicyUrl and TermsAndConditionsUrl fields; no TFV fee mentioned · accessed 25 October 2026 · official
- Twilio error 30493 Rejection when Terms of Service URL is missing, unreachable, or lacks message rates, frequency and opt-out instructions · accessed 25 October 2026 · official
- Twilio error 30475 Rejection when messaging consent is bundled with other agreements; needs standalone consent action · accessed 25 October 2026 · official
- Twilio error 30444 Rejection when business, programme or samples are identified with fraud or deceptive messaging; contact Support if wrong · accessed 25 October 2026 · official
- Twilio error 30483 Rejection when a generic role (Admin, Support) is entered instead of an authorised business representative · accessed 25 October 2026 · official
- Twilio error 30503 Rejection when the confirmation message lacks business name, customer care info, opt-out instructions or pricing statement · accessed 25 October 2026 · official
- EmbedMyReviews – Twilio toll-free number for US and Canada Third-party report that full verification can take much longer than Twilio's stated time because of carrier backlog [community] · accessed 25 October 2026 · community
Provider rules change. This page is generated from verapli registry version 2026.1025.316; spotted something out of date? Tell us. Twilio is not affiliated with verapli.