{"registry_version":"2026.1025.387","generated_at":"2026-10-25T06:27:00Z","content_sha256":"089d16f627d9365e3d0663cc8069203706d7cb23a76c332226e29686968811a5","signed":true,"signature":{"key_id":"ed25519:74ca19268e364242","algorithm":"ed25519","expires_at":"2026-11-24T06:27:09Z","expired":false,"manifest":"/registry/manifest.json"},"entry_sha256":"6f30b8c94aae4f193ac23252ff3f468b42197d2fed355f60d9e2d474d08761aa","entry":{"id":"twilio/toll-free-verification","name":"Twilio toll-free verification (US/Canada SMS)","vendor":"Twilio","summary":"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.","aliases":["twilio-tfv","toll-free-verification","tfv"],"category":"messaging","group":"B","homepage":"https://www.twilio.com/docs/messaging/compliance/toll-free","docs":["https://www.twilio.com/docs/messaging/compliance/toll-free/console-onboarding","https://www.twilio.com/docs/messaging/compliance/toll-free/api-onboarding"],"status":"researched","last_verified":null,"last_researched":"2026-10-25","sources":[{"id":"console","url":"https://www.twilio.com/docs/messaging/compliance/toll-free/console-onboarding","title":"Twilio docs – Toll-free verification console onboarding guide","accessed":"2026-10-25","supports":"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","kind":"official"},{"id":"api","url":"https://www.twilio.com/docs/messaging/compliance/toll-free/api-onboarding","title":"Twilio docs – Toll-free verification API onboarding guide","accessed":"2026-10-25","supports":"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)","kind":"official"},{"id":"overview","url":"https://www.twilio.com/docs/messaging/compliance/toll-free","title":"Twilio docs – Toll-free verification overview","accessed":"2026-10-25","supports":"Twilio reviews TFV requests within three business days; PrivacyPolicyUrl and TermsAndConditionsUrl fields; no TFV fee mentioned","kind":"official"},{"id":"err-30493","url":"https://www.twilio.com/docs/api/errors/30493","title":"Twilio error 30493","accessed":"2026-10-25","supports":"Rejection when Terms of Service URL is missing, unreachable, or lacks message rates, frequency and opt-out instructions","kind":"official"},{"id":"err-30475","url":"https://www.twilio.com/docs/api/errors/30475","title":"Twilio error 30475","accessed":"2026-10-25","supports":"Rejection when messaging consent is bundled with other agreements; needs standalone consent action","kind":"official"},{"id":"err-30444","url":"https://www.twilio.com/docs/api/errors/30444","title":"Twilio error 30444","accessed":"2026-10-25","supports":"Rejection when business, programme or samples are identified with fraud or deceptive messaging; contact Support if wrong","kind":"official"},{"id":"err-30483","url":"https://www.twilio.com/docs/api/errors/30483","title":"Twilio error 30483","accessed":"2026-10-25","supports":"Rejection when a generic role (Admin, Support) is entered instead of an authorised business representative","kind":"official"},{"id":"err-30503","url":"https://www.twilio.com/docs/api/errors/30503","title":"Twilio error 30503","accessed":"2026-10-25","supports":"Rejection when the confirmation message lacks business name, customer care info, opt-out instructions or pricing statement","kind":"official"},{"id":"vendor-delay","url":"https://www.embedmyreviews.com/docs/messaging-and-ai/twilio-toll-free-number-for-us-and-canada/","title":"EmbedMyReviews – Twilio toll-free number for US and Canada","accessed":"2026-10-25","supports":"Third-party report that full verification can take much longer than Twilio's stated time because of carrier backlog [community]","kind":"community"}],"allowed_domains":["twilio.com"],"account_model":{"summary":"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.","accounts":[{"name":"Twilio account (paid)","kind":"organisation","required":true},{"name":"Trust Hub Primary Customer Profile (BU…)","kind":"organisation","parent":"Twilio account (paid)","required":true,"note":"Set up before buying the toll-free number."},{"name":"Toll-free number (PN…)","kind":"other","parent":"Twilio account (paid)","required":true}]},"prerequisites":[{"entry":"twilio/account-and-keys","note":"Trial accounts cannot complete toll-free verification."}],"have_ready":[{"kind":"tax_id","description":"Business registration number (US EIN), issuing authority and country, exactly as registered","why":"Required for all business types except sole proprietor.","needed_for":["submit-verification"],"auto_check":"name_consistency","source":"api"},{"kind":"live_website","description":"Live business website matching the business name","why":"Business website is a required field and is checked by reviewers.","needed_for":["submit-verification"],"auto_check":"website_live","source":"api"},{"kind":"app_privacy_policy_url","description":"Public privacy policy URL and Terms of Service URL with SMS disclosures (message rates, frequency, opt-out)","why":"Missing or incomplete Terms of Service is rejected with error 30493.","needed_for":["submit-verification"],"auto_check":"website_live","source":"err-30493"},{"kind":"other","description":"Screenshots of the opt-in flow hosted at public URLs, with a separate consent checkbox or action","why":"Opt-in image URLs are required, and bundled consent is rejected (error 30475).","needed_for":["submit-verification"],"auto_check":"none","source":"err-30475"},{"kind":"other","description":"A real sample production message and the confirmation message (business name, help, STOP, rates)","why":"Required field; incomplete confirmation messages are rejected (error 30503).","needed_for":["submit-verification"],"auto_check":"none","source":"err-30503"},{"kind":"other","description":"Name, email and phone of an authorised business representative (a real person, not \"Admin\")","why":"Generic roles are rejected (error 30483).","needed_for":["submit-verification"],"auto_check":"none","source":"err-30483"}],"steps":[{"id":"account","title":"Use an upgraded Twilio account","summary":"Sign in to a paid Twilio account.","route":"guided","depends_on":[],"gate":"human_login","sources":["console"]},{"id":"trust-hub-profile","title":"Create a Trust Hub customer profile","summary":"Create the Primary (or Secondary) Compliance Profile in Trust Hub describing your business, before buying the number.","route":"guided","depends_on":["account"],"gate":"human_submit","url":"https://console.twilio.com/","preflight":["legal_name_matches_documents"],"sources":["console","api"]},{"id":"buy-number","title":"Buy a toll-free number","summary":"Buy a toll-free number, choosing Business / Nonprofit / Sole Proprietor. Twilio charges the full monthly price on purchase.","route":"guided","depends_on":["trust-hub-profile"],"gate":"human_payment","sources":["console"]},{"id":"submit-verification","title":"Submit the toll-free verification","summary":"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.","route":"guided","depends_on":["buy-number"],"gate":"human_submit","preflight":["website_live","website_not_form_only","privacy_policy_reachable","domain_email_matches_website"],"sources":["console","api"]},{"id":"review","title":"Wait for Twilio review","summary":"Status moves from Not verified (Restricted) to Verification in progress (Pending) to Approved (Verified) or Rejected.","route":"guided","depends_on":["submit-verification"],"gate":"third_party_review","lead_time":{"official":{"text":"Twilio reviews TFV requests within three business days.","source":"overview"},"reported":{"text":"Some third-party vendors report much longer waits because of carrier backlog.","source":"vendor-delay"}},"recovery":[{"hiccup":"Rejected for Terms of Service URL","code":"30493","fix":"Publish a public Terms page covering message rates, frequency and opt-out, check it loads logged out, then resubmit.","source":"err-30493"},{"hiccup":"Rejected because consent is bundled with other terms","code":"30475","fix":"Add a standalone, optional messaging consent action, capture new screenshots, and resubmit.","source":"err-30475"},{"hiccup":"Rejected for incomplete confirmation message","code":"30503","fix":"Add business name, customer care contact, opt-out instructions and pricing statement to the confirmation message.","source":"err-30503"},{"hiccup":"Rejected because a generic contact role was entered","code":"30483","fix":"Enter the name and details of a real authorised representative.","source":"err-30483"},{"hiccup":"Rejected as fraud or deceptive messaging","code":"30444","fix":"If wrong, contact Twilio Support explaining the business and use case.","source":"err-30444"},{"hiccup":"Rejection resubmitted late","fix":"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.","source":"console"}],"sources":["console","overview"]}],"outputs":[{"name":"TWILIO_TOLL_FREE_NUMBER","description":"Verified toll-free sending number","secret":false,"example_format":"+1 8XX XXX XXXX","from_step":"buy-number"}],"terms_notes":[{"kind":"rules_say","severity":"red","text":"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.","source":"console"},{"kind":"rules_say","severity":"amber","text":"The full monthly number price is charged when the number is bought, whether or not verification is approved.","source":"console"},{"kind":"rules_say","severity":"amber","text":"Consent bundled with general terms or required to use the service is rejected; opt-in must be its own action.","source":"err-30475"},{"kind":"people_report","severity":"yellow","text":"Third-party vendors report end-to-end verification sometimes taking far longer than Twilio's three business days. [community]","source":"vendor-delay"}],"pricing_notes":{"costs":"No toll-free verification fee is mentioned in Twilio's docs; you pay for the number and messages.","source":"overview"},"stripe_projects":false,"api_provisioning":{"available":"yes","notes":"POST https://messaging.twilio.com/v1/Tollfree/Verifications creates a request; edits via the Edit TFV resource when edit_allowed is true.","docs":["https://www.twilio.com/docs/messaging/compliance/toll-free/api-onboarding"],"source":"api"}}}