---
title: "Changes to Create a tollfree verification"
method: POST
path: "/v1/Tollfree/Verifications"
---

# Changes to Create a tollfree verification

`POST /v1/Tollfree/Verifications`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 14 of 103 revisions.

- **2026-03-10** (v1) `ef8fb6b6bfee` — 3 breaking, 32 warning, 40 info
- **2026-01-07** (v1) `84b2771d2bba` — 5 info
- **2025-10-14** (v1) `4c488bab0a5f` — 12 info
- **2025-09-30** (v1) `dfa6304799eb` — 13 info
- **2025-08-18** (v1) `1001b3de9885` — 1 breaking
- **2025-07-10** (v1) `59b0953d2c63` — 1 breaking
- **2025-03-11** (v1) `67b38e582c68` — 2 breaking, 1 warning, 1 info
- **2024-06-06** (v1) `b31951a64015` — 1 warning, 1 info
- **2024-02-27** (v1) `968e4aa69823` — 1 info
- **2024-02-09** (v1) `a41ed9727dd6` — 1 info
- **2024-01-25** (v1) `c4b8c1c6b592` — 1 warning
- **2023-11-17** (v1) `c27ba480d0ce` — 1 info
- **2023-08-10** (v1) `8faf72964735` — 1 info
- **2023-07-13** (v1) `9a71ea745888` — 1 info

## Changes

- **2026-03-10** (v1) `ef8fb6b6bfee` — 3 breaking, 32 warning, 40 info
  - request property `BusinessRegistrationAuthority` was restricted to a list of enum values
  - request property `BusinessType` was restricted to a list of enum values
  - request property `UseCaseCategories/items/` was restricted to a list of enum values
  - added the new `ABN` enum value to the `business_registration_authority` response property for the response status `201`
  - added the new `ACCOUNT_NOTIFICATIONS` enum value to the `use_case_categories/items/` response property for the response status `201`
  - added the new `ACN` enum value to the `business_registration_authority` response property for the response status `201`
  - added the new `BRN` enum value to the `business_registration_authority` response property for the response status `201`
  - added the new `CBN` enum value to the `business_registration_authority` response property for the response status `201`
  - added the new `CHARITY_NONPROFIT` enum value to the `use_case_categories/items/` response property for the response status `201`
  - added the new `CIF` enum value to the `business_registration_authority` response property for the response status `201`
  - added the new `CNPJ` enum value to the `business_registration_authority` response property for the response status `201`
  - added the new `CRN` enum value to the `business_registration_authority` response property for the response status `201`
  - added the new `CUSTOMER_CARE` enum value to the `use_case_categories/items/` response property for the response status `201`
  - added the new `DELIVERY_NOTIFICATIONS` enum value to the `use_case_categories/items/` response property for the response status `201`
  - added the new `EIN` enum value to the `business_registration_authority` response property for the response status `201`
  - added the new `EVENTS` enum value to the `use_case_categories/items/` response property for the response status `201`
  - added the new `FRAUD_ALERT_MESSAGING` enum value to the `use_case_categories/items/` response property for the response status `201`
  - added the new `HIGHER_EDUCATION` enum value to the `use_case_categories/items/` response property for the response status `201`
  - added the new `K12` enum value to the `use_case_categories/items/` response property for the response status `201`
  - added the new `MARKETING` enum value to the `use_case_categories/items/` response property for the response status `201`
  - added the new `NEQ` enum value to the `business_registration_authority` response property for the response status `201`
  - added the new `NIF` enum value to the `business_registration_authority` response property for the response status `201`
  - added the new `NZBN` enum value to the `business_registration_authority` response property for the response status `201`
  - added the new `OTHER` enum value to the `business_registration_authority` response property for the response status `201`
  - added the new `POLITICAL_ELECTION_CAMPAIGNS` enum value to the `use_case_categories/items/` response property for the response status `201`
  - added the new `POLLING_AND_VOTING_NON_POLITICAL` enum value to the `use_case_categories/items/` response property for the response status `201`
  - added the new `PROVINCIAL_NUMBER` enum value to the `business_registration_authority` response property for the response status `201`
  - added the new `PUBLIC_SERVICE_ANNOUNCEMENT` enum value to the `use_case_categories/items/` response property for the response status `201`
  - added the new `SECURITY_ALERT` enum value to the `use_case_categories/items/` response property for the response status `201`
  - added the new `SIREN` enum value to the `business_registration_authority` response property for the response status `201`
  - added the new `SIRET` enum value to the `business_registration_authority` response property for the response status `201`
  - added the new `TWO_FACTOR_AUTHENTICATION` enum value to the `use_case_categories/items/` response property for the response status `201`
  - added the new `UID` enum value to the `business_registration_authority` response property for the response status `201`
  - added the new `USt-IdNr` enum value to the `business_registration_authority` response property for the response status `201`
  - added the new `VAT` enum value to the `business_registration_authority` response property for the response status `201`
  - the request property `BusinessRegistrationAuthority` became nullable
  - the request property `BusinessType` became nullable
  - the request property `UseCaseCategories` became nullable
  - added the new `ABN` enum value to the request property `BusinessRegistrationAuthority`
  - added the new `ACCOUNT_NOTIFICATIONS` enum value to the request property `UseCaseCategories/items/`
  - …35 more
- **2026-01-07** (v1) `84b2771d2bba` — 5 info
  - added the new optional request property `VettingId`
  - added the new optional request property `VettingProvider`
  - added the optional property `vetting_id` to the response with the `201` status
  - added the optional property `vetting_id_expiration` to the response with the `201` status
  - added the optional property `vetting_provider` to the response with the `201` status
- **2025-10-14** (v1) `4c488bab0a5f` — 12 info
  - added the new optional request property `AgeGatedContent`
  - added the new optional request property `BusinessRegistrationAuthority`
  - added the new optional request property `BusinessRegistrationCountry`
  - added the new optional request property `BusinessRegistrationNumber`
  - added the new optional request property `BusinessRegistrationPhoneNumber`
  - added the new optional request property `BusinessType`
  - added the new optional request property `DoingBusinessAs`
  - added the new optional request property `HelpMessageSample`
  - added the new optional request property `OptInConfirmationMessage`
  - added the new optional request property `OptInKeywords`
  - added the new optional request property `PrivacyPolicyUrl`
  - added the new optional request property `TermsAndConditionsUrl`
- **2025-09-30** (v1) `dfa6304799eb` — 13 info
  - added the optional property `age_gated_content` to the response with the `201` status
  - added the optional property `business_registration_authority` to the response with the `201` status
  - added the optional property `business_registration_country` to the response with the `201` status
  - added the optional property `business_registration_number` to the response with the `201` status
  - added the optional property `business_registration_phone_number` to the response with the `201` status
  - added the optional property `business_type` to the response with the `201` status
  - added the optional property `doing_business_as` to the response with the `201` status
  - added the optional property `help_message_sample` to the response with the `201` status
  - added the optional property `opt_in_confirmation_message` to the response with the `201` status
  - added the optional property `opt_in_keywords` to the response with the `201` status
  - added the optional property `privacy_policy_url` to the response with the `201` status
  - added the optional property `terms_and_conditions_url` to the response with the `201` status
  - added the optional property `tollfree_phone_number` to the response with the `201` status
- **2025-08-18** (v1) `1001b3de9885` — 1 breaking
  - the `resource_links` response's property type changed from `object` to no type for status `201`
- **2025-07-10** (v1) `59b0953d2c63` — 1 breaking
  - the `rejection_reasons/items/` response's property type changed from `object` to no type for status `201`
- **2025-03-11** (v1) `67b38e582c68` — 2 breaking, 1 warning, 1 info
  - the `rejection_reasons/items/` response's property type changed from no type to `object` for status `201`
  - the `resource_links` response's property type changed from no type to `object` for status `201`
  - added the new `IMPORT_PLEASE_REPLACE` enum value to the `opt_in_type` response property for the response status `201`
  - added the new `IMPORT_PLEASE_REPLACE` enum value to the request property `OptInType`
- **2024-06-06** (v1) `b31951a64015` — 1 warning, 1 info
  - added the new `IMPORT` enum value to the `opt_in_type` response property for the response status `201`
  - added the new `IMPORT` enum value to the request property `OptInType`
- **2024-02-27** (v1) `968e4aa69823` — 1 info
  - added the optional property `rejection_reasons` to the response with the `201` status
- **2024-02-09** (v1) `a41ed9727dd6` — 1 info
  - added the optional property `edit_allowed` to the response with the `201` status
- **2024-01-25** (v1) `c4b8c1c6b592` — 1 warning
  - removed the optional property `edit_allowed` from the response with the `201` status
- **2023-11-17** (v1) `c27ba480d0ce` — 1 info
  - added the optional property `edit_allowed` to the response with the `201` status
- **2023-08-10** (v1) `8faf72964735` — 1 info
  - api tag `MessagingV1TollfreeVerification` added
- **2023-07-13** (v1) `9a71ea745888` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/twilio/apis/twilio-messaging/docs/v1/Tollfree/Verifications/post.md) · [API](https://skmtc.dev/twilio/apis/twilio-messaging.md) · [Page](https://skmtc.dev/twilio/apis/twilio-messaging/changes/v1/Tollfree/Verifications/post)
