---
title: "Create a tollfree verification"
method: POST
path: "/v1/Tollfree/Verifications"
tags: ["MessagingV1TollfreeVerification"]
---

# Create a tollfree verification

`POST /v1/Tollfree/Verifications`

Create a tollfree verification

## Response `201`

Created

- MessagingV1TollfreeVerification
  - `sid` string, nullable — The unique string to identify Tollfree Verification.
  - `account_sid` string, nullable — The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Tollfree Verification resource.
  - `customer_profile_sid` string, nullable — Customer's Profile Bundle BundleSid.
  - `trust_product_sid` string, nullable — Tollfree TrustProduct Bundle BundleSid.
  - `date_created` string, date-time, nullable — The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `date_updated` string, date-time, nullable — The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `regulated_item_sid` string, nullable — The SID of the Regulated Item.
  - `business_name` string, nullable — The name of the business or organization using the Tollfree number.
  - `business_street_address` string, nullable — The address of the business or organization using the Tollfree number.
  - `business_street_address2` string, nullable — The address of the business or organization using the Tollfree number.
  - `business_city` string, nullable — The city of the business or organization using the Tollfree number.
  - `business_state_province_region` string, nullable — The state/province/region of the business or organization using the Tollfree number.
  - `business_postal_code` string, nullable — The postal code of the business or organization using the Tollfree number.
  - `business_country` string, nullable — The country of the business or organization using the Tollfree number.
  - `business_website` string, nullable — The website of the business or organization using the Tollfree number.
  - `business_contact_first_name` string, nullable — The first name of the contact for the business or organization using the Tollfree number.
  - `business_contact_last_name` string, nullable — The last name of the contact for the business or organization using the Tollfree number.
  - `business_contact_email` string, nullable — The email address of the contact for the business or organization using the Tollfree number.
  - `business_contact_phone` string, phone-number, nullable — The E.164 formatted phone number of the contact for the business or organization using the Tollfree number.
  - `notification_email` string, nullable — The email address to receive the notification about the verification result. .
  - `use_case_categories` string[], nullable — The category of the use case for the Tollfree Number. List as many as are applicable.
  - `use_case_summary` string, nullable — Use this to further explain how messaging is used by the business or organization.
  - `production_message_sample` string, nullable — An example of message content, i.e. a sample message.
  - `opt_in_image_urls` string[], nullable — Link to an image that shows the opt-in workflow. Multiple images allowed and must be a publicly hosted URL.
  - `opt_in_type` 'VERBAL' | 'WEB_FORM' | 'PAPER_FORM' | 'VIA_TEXT' | 'MOBILE_QR_CODE' | 'IMPORT' | 'IMPORT_PLEASE_REPLACE' — Describe how a user opts-in to text messages.
  - `message_volume` string, nullable — Estimate monthly volume of messages from the Tollfree Number.
  - `additional_information` string, nullable — Additional information to be provided for verification.
  - `tollfree_phone_number_sid` string, nullable — The SID of the Phone Number associated with the Tollfree Verification.
  - `tollfree_phone_number` string, phone-number, nullable — The E.164 formatted toll-free phone number associated with the verification.
  - `status` 'PENDING_REVIEW' | 'IN_REVIEW' | 'TWILIO_APPROVED' | 'TWILIO_REJECTED' — The compliance status of the Tollfree Verification record.
  - `url` string, uri, nullable — The absolute URL of the Tollfree Verification resource.
  - `rejection_reason` string, nullable — The rejection reason given when a Tollfree Verification has been rejected.
  - `error_code` integer, nullable — The error code given when a Tollfree Verification has been rejected.
  - `edit_expiration` string, date-time, nullable — The date and time when the ability to edit a rejected verification expires.
  - `edit_allowed` boolean, nullable — If a rejected verification is allowed to be edited/resubmitted. Some rejection reasons allow editing and some do not.
  - `business_registration_number` string, nullable — A legally recognized business registration number
  - `business_registration_authority` 'EIN' | 'CBN' | 'CRN' | 'PROVINCIAL_NUMBER' | 'VAT' | 'ACN' | 'ABN' | 'BRN' | 'SIREN' | 'SIRET' | 'NZBN' | 'USt-IdNr' | 'CIF' | 'NIF' | 'CNPJ' | 'UID' | 'NEQ' | 'OTHER', nullable — The organizational authority for business registrations. Required for all business types except SOLE_PROPRIETOR.
  - `business_registration_country` string, nullable — Country business is registered in
  - `business_type` 'PRIVATE_PROFIT' | 'PUBLIC_PROFIT' | 'SOLE_PROPRIETOR' | 'NON_PROFIT' | 'GOVERNMENT', nullable — The type of business, valid values are PRIVATE_PROFIT, PUBLIC_PROFIT, NON_PROFIT, SOLE_PROPRIETOR, GOVERNMENT. Required field.
  - `business_registration_phone_number` string, nullable — The E.164 formatted number associated with the business.
  - `doing_business_as` string, nullable — Trade name, sub entity, or downstream business name of business being submitted for verification
  - `opt_in_confirmation_message` string, nullable — The confirmation message sent to users when they opt in to receive messages.
  - `help_message_sample` string, nullable — A sample help message provided to users.
  - `privacy_policy_url` string, uri, nullable — The URL to the privacy policy for the business or organization.
  - `terms_and_conditions_url` string, uri, nullable — The URL of the terms and conditions for the business or organization.
  - `age_gated_content` boolean, nullable — Indicates if the content is age gated.
  - `opt_in_keywords` string[], nullable — List of keywords that users can send to opt in or out of messages.
  - `rejection_reasons` unknown[], nullable — A list of rejection reasons and codes describing why a Tollfree Verification has been rejected.
    - unknown
  - `resource_links` unknown
  - `external_reference_id` string, nullable — An optional external reference ID supplied by customer and echoed back on status retrieval.
  - `vetting_id` string, nullable
  - `vetting_provider` 'CAMPAIGN_VERIFY', nullable — The third-party political vetting provider.
  - `vetting_id_expiration` string, date-time, nullable

---

[API](https://skmtc.net/twilio/apis/messaging-v1.md) · [All operations](https://skmtc.net/twilio/apis/messaging-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/messaging-v1/versions/ef8fb6b6bfee/schema)