--- title: "Create a new Compliance Tollfree Verification Inquiry for the authenticated account. This is necessary to start a new embedded session." method: POST path: "/v1/ComplianceInquiries/Tollfree/Initialize" tags: ["TrusthubV1ComplianceTollfreeInquiries"] --- # Create a new Compliance Tollfree Verification Inquiry for the authenticated account. This is necessary to start a new embedded session. `POST /v1/ComplianceInquiries/Tollfree/Initialize` ## Request - Base URL: `https://trusthub.twilio.com` - URL: `https://trusthub.twilio.com/v1/ComplianceInquiries/Tollfree/Initialize` - Auth: HTTP basic Create a new Compliance Tollfree Verification Inquiry for the authenticated account. This is necessary to start a new embedded session. ## Request body `application/x-www-form-urlencoded` - object - `TollfreePhoneNumber` string, phone-number, required: The Tollfree phone number to be verified - `NotificationEmail` string, required: The email address to receive the notification about the verification result. - `CustomerProfileSid` string: The Customer Profile Sid associated with the Account. - `BusinessName` string: The name of the business or organization using the Tollfree number. - `BusinessWebsite` string: The website of the business or organization using the Tollfree number. - `UseCaseCategories` string[]: The category of the use case for the Tollfree Number. List as many are applicable.. - `UseCaseSummary` string: Use this to further explain how messaging is used by the business or organization. - `ProductionMessageSample` string: An example of message content, i.e. a sample message. - `OptInImageUrls` string[]: Link to an image that shows the opt-in workflow. Multiple images allowed and must be a publicly hosted URL. - `OptInType` 'VERBAL' | 'WEB_FORM' | 'PAPER_FORM' | 'VIA_TEXT' | 'MOBILE_QR_CODE': Describe how a user opts-in to text messages. - `MessageVolume` string: Estimate monthly volume of messages from the Tollfree Number. - `BusinessStreetAddress` string: The address of the business or organization using the Tollfree number. - `BusinessStreetAddress2` string: The address of the business or organization using the Tollfree number. - `BusinessCity` string: The city of the business or organization using the Tollfree number. - `BusinessStateProvinceRegion` string: The state/province/region of the business or organization using the Tollfree number. - `BusinessPostalCode` string: The postal code of the business or organization using the Tollfree number. - `BusinessCountry` string: The country of the business or organization using the Tollfree number. - `AdditionalInformation` string: Additional information to be provided for verification. - `BusinessContactFirstName` string: The first name of the contact for the business or organization using the Tollfree number. - `BusinessContactLastName` string: The last name of the contact for the business or organization using the Tollfree number. - `BusinessContactEmail` string: The email address of the contact for the business or organization using the Tollfree number. - `BusinessContactPhone` string, phone-number: The phone number of the contact for the business or organization using the Tollfree number. - `ThemeSetId` string: Theme id for styling the inquiry form. - `SkipMessagingUseCase` boolean: Skip the messaging use case screen of the inquiry form. - `BusinessRegistrationNumber` string: The Business Registration Number of the business or organization. - `BusinessRegistrationAuthority` string: The Business Registration Authority of the business or organization. - `BusinessRegistrationCountry` string: The Business Registration Country of the business or organization. - `BusinessType` 'PRIVATE_PROFIT' | 'PUBLIC_PROFIT' | 'NON_PROFIT' | 'SOLE_PROPRIETOR' | 'GOVERNMENT': Type of Business. - `DoingBusinessAs` string: Trade name, sub entity, or downstream business name of business being submitted for verification. - `OptInConfirmationMessage` string: The confirmation message sent to users when they opt in to receive messages. - `HelpMessageSample` string: A sample help message provided to users. - `PrivacyPolicyUrl` string: The URL to the privacy policy for the business or organization. - `TermsAndConditionsUrl` string: The URL to the terms and conditions for the business or organization. - `AgeGatedContent` boolean: Indicates if the content is age gated. - `ExternalReferenceId` string: A legally recognized business registration number. - `OptInKeywords` string[]: List of keywords that users can text in to opt in to receive messages. - `VettingId` string: Unique identifier for the created Vetting . - `VettingProvider` string: Name of the vetting provider. ## Response `201` Created - TrusthubV1ComplianceTollfreeInquiry - `inquiry_id` string, nullable: The unique ID used to start an embedded compliance registration session. - `inquiry_session_token` string, nullable: The session token used to start an embedded compliance registration session. - `registration_id` string, nullable: The TolfreeId matching the Tollfree Profile that should be resumed or resubmitted for editing. - `url` string, uri, nullable: The URL of this resource. ## Changes - **2026-01-22** (v1) `4a9e402f6fc7`: 2 info - added the new optional request property `VettingId` - added the new optional request property `VettingProvider` - **2025-12-17** (v1) `6211bab972ca`: 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` - …8 more - **2025-12-03** (v1) `e077757f206e`: 1 info - added the new optional request property `CustomerProfileSid` - **2024-06-18** (v1) `d53d7cae88d0`: 1 info - added the new optional request property `SkipMessagingUseCase` - **2024-05-24** (v1) `ed1865f0e05d`: 1 info - added the new optional request property `ThemeSetId` [Operation history](https://skmtc.dev/twilio/apis/trusthub-v1/changes/v1/ComplianceInquiries/Tollfree/Initialize/post.md) --- [API](https://skmtc.dev/twilio/apis/trusthub-v1.md) - [All operations](https://skmtc.dev/twilio/apis/trusthub-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/trusthub-v1/revisions/efbeb2fac001?raw)