# Toll-free verification resource The **Verification** resource records your request to verify a toll-free number to comply with US and Canadian federal regulations for SMS messaging. The verification process is called toll-free verification (TFV). Toll-free phone numbers for the US and Canada use the North American Numbering Plan (NANP). NANP toll-free numbers begin with 800, 888, 877, 866, 855, 844, or 833. To use these numbers to send SMS messages, your organization must comply with federal regulations. For the toll-free number to be compliant, provide data on how you plan to use your phone number to send texts. To verify that a toll-free number meets these regulations, use this resource. To learn how to use this resource, see [Get started with toll-free verification using the API][tfv-start]. [tfv-start]: /docs/messaging/compliance/toll-free/api-onboarding ## Verification Properties ```json {"type":"object","refName":"messaging.v1.tollfree_verification","modelName":"messaging_v1_tollfree_verification","properties":{"sid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^HH[0-9a-fA-F]{32}$","nullable":true,"description":"The unique string to identify Tollfree Verification."},"account_sid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^AC[0-9a-fA-F]{32}$","nullable":true,"description":"The SID of the [Account](/docs/iam/api/account) that created the Tollfree Verification resource."},"customer_profile_sid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^BU[0-9a-fA-F]{32}$","nullable":true,"description":"Customer's Profile Bundle BundleSid."},"trust_product_sid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^BU[0-9a-fA-F]{32}$","nullable":true,"description":"Tollfree TrustProduct Bundle BundleSid."},"date_created":{"type":"string","format":"date-time","nullable":true,"description":"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":{"type":"string","format":"date-time","nullable":true,"description":"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":{"type":"string","minLength":34,"maxLength":34,"pattern":"^RA[0-9a-fA-F]{32}$","nullable":true,"description":"The SID of the Regulated Item."},"business_name":{"type":"string","nullable":true,"description":"The name of the business or organization using the Tollfree number."},"business_street_address":{"type":"string","nullable":true,"description":"The address of the business or organization using the Tollfree number."},"business_street_address2":{"type":"string","nullable":true,"description":"The address of the business or organization using the Tollfree number."},"business_city":{"type":"string","nullable":true,"description":"The city of the business or organization using the Tollfree number."},"business_state_province_region":{"type":"string","nullable":true,"description":"The state/province/region of the business or organization using the Tollfree number."},"business_postal_code":{"type":"string","nullable":true,"description":"The postal code of the business or organization using the Tollfree number."},"business_country":{"type":"string","nullable":true,"description":"The country of the business or organization using the Tollfree number."},"business_website":{"type":"string","nullable":true,"description":"The website of the business or organization using the Tollfree number."},"business_contact_first_name":{"type":"string","nullable":true,"description":"The first name of the contact for the business or organization using the Tollfree number."},"business_contact_last_name":{"type":"string","nullable":true,"description":"The last name of the contact for the business or organization using the Tollfree number."},"business_contact_email":{"type":"string","nullable":true,"description":"The email address of the contact for the business or organization using the Tollfree number."},"business_contact_phone":{"type":"string","format":"phone-number","nullable":true,"description":"The E.164 formatted phone number of the contact for the business or organization using the Tollfree number."},"notification_email":{"type":"string","nullable":true,"description":"The email address to receive the notification about the verification result. ."},"use_case_categories":{"type":"array","nullable":true,"description":"The category of the use case for the Tollfree Number. List as many as are applicable.","refName":"tollfree_verification_enum_use_case_categories","modelName":"tollfree_verification_enum_use_case_categories","items":{"type":"string","enum":["TWO_FACTOR_AUTHENTICATION","ACCOUNT_NOTIFICATIONS","CUSTOMER_CARE","CHARITY_NONPROFIT","DELIVERY_NOTIFICATIONS","FRAUD_ALERT_MESSAGING","EVENTS","HIGHER_EDUCATION","K12","MARKETING","POLLING_AND_VOTING_NON_POLITICAL","POLITICAL_ELECTION_CAMPAIGNS","PUBLIC_SERVICE_ANNOUNCEMENT","SECURITY_ALERT"]}},"use_case_summary":{"type":"string","nullable":true,"description":"Use this to further explain how messaging is used by the business or organization."},"production_message_sample":{"type":"string","nullable":true,"description":"An example of message content, i.e. a sample message."},"opt_in_image_urls":{"type":"array","nullable":true,"description":"Link to an image that shows the opt-in workflow. Multiple images allowed and must be a publicly hosted URL.","items":{"type":"string"}},"opt_in_type":{"type":"string","enum":["VERBAL","WEB_FORM","PAPER_FORM","VIA_TEXT","MOBILE_QR_CODE","IMPORT","IMPORT_PLEASE_REPLACE"],"description":"Describe how a user opts-in to text messages.","refName":"tollfree_verification_enum_opt_in_type","modelName":"tollfree_verification_enum_opt_in_type"},"message_volume":{"type":"string","nullable":true,"description":"Estimate monthly volume of messages from the Tollfree Number."},"additional_information":{"type":"string","nullable":true,"description":"Additional information to be provided for verification."},"tollfree_phone_number_sid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^PN[0-9a-fA-F]{32}$","nullable":true,"description":"The SID of the Phone Number associated with the Tollfree Verification."},"tollfree_phone_number":{"type":"string","format":"phone-number","nullable":true,"description":"The E.164 formatted toll-free phone number associated with the verification."},"status":{"type":"string","enum":["PENDING_REVIEW","IN_REVIEW","TWILIO_APPROVED","TWILIO_REJECTED"],"description":"The compliance status of the Tollfree Verification record.","refName":"tollfree_verification_enum_status","modelName":"tollfree_verification_enum_status"},"url":{"type":"string","format":"uri","nullable":true,"description":"The absolute URL of the Tollfree Verification resource."},"rejection_reason":{"type":"string","nullable":true,"description":"The rejection reason given when a Tollfree Verification has been rejected."},"error_code":{"type":"integer","nullable":true,"description":"The error code given when a Tollfree Verification has been rejected."},"edit_expiration":{"type":"string","format":"date-time","nullable":true,"description":"The date and time when the ability to edit a rejected verification expires."},"edit_allowed":{"type":"boolean","nullable":true,"description":"If a rejected verification is allowed to be edited/resubmitted. Some rejection reasons allow editing and some do not."},"business_registration_number":{"type":"string","nullable":true,"description":"A legally recognized business registration number"},"business_registration_authority":{"type":"string","nullable":true,"enum":["EIN","CBN","CRN","PROVINCIAL_NUMBER","VAT","ACN","ABN","BRN","SIREN","SIRET","NZBN","USt-IdNr","CIF","NIF","CNPJ","UID","NEQ","OTHER"],"description":"The organizational authority for business registrations. Required for all business types except SOLE_PROPRIETOR.","refName":"tollfree_verification_enum_business_registration_authority","modelName":"tollfree_verification_enum_business_registration_authority"},"business_registration_country":{"type":"string","nullable":true,"description":"Country business is registered in"},"business_type":{"type":"string","enum":["PRIVATE_PROFIT","PUBLIC_PROFIT","SOLE_PROPRIETOR","NON_PROFIT","GOVERNMENT"],"nullable":true,"description":"The type of business, valid values are PRIVATE_PROFIT, PUBLIC_PROFIT, NON_PROFIT, SOLE_PROPRIETOR, GOVERNMENT. Required field.","refName":"tollfree_verification_enum_business_type","modelName":"tollfree_verification_enum_business_type"},"business_registration_phone_number":{"type":"string","nullable":true,"description":"The E.164 formatted number associated with the business."},"doing_business_as":{"type":"string","nullable":true,"description":"Trade name, sub entity, or downstream business name of business being submitted for verification"},"opt_in_confirmation_message":{"type":"string","nullable":true,"description":"The confirmation message sent to users when they opt in to receive messages."},"help_message_sample":{"type":"string","nullable":true,"description":"A sample help message provided to users."},"privacy_policy_url":{"type":"string","format":"uri","nullable":true,"description":"The URL to the privacy policy for the business or organization."},"terms_and_conditions_url":{"type":"string","format":"uri","nullable":true,"description":"The URL of the terms and conditions for the business or organization."},"age_gated_content":{"type":"boolean","nullable":true,"description":"Indicates if the content is age gated."},"opt_in_keywords":{"type":"array","nullable":true,"description":"List of keywords that users can send to opt in or out of messages.","items":{"type":"string"}},"rejection_reasons":{"type":"array","nullable":true,"description":"A list of rejection reasons and codes describing why a Tollfree Verification has been rejected."},"resource_links":{"nullable":true,"description":"The URLs of the documents associated with the Tollfree Verification resource."},"external_reference_id":{"type":"string","nullable":true,"description":"An optional external reference ID supplied by customer and echoed back on status retrieval."},"vetting_id":{"type":"string","nullable":true,"maxLength":500},"vetting_provider":{"type":"string","nullable":true,"enum":["CAMPAIGN_VERIFY"],"description":"The third-party political vetting provider.","refName":"tollfree_verification_enum_vetting_provider","modelName":"tollfree_verification_enum_vetting_provider"},"vetting_id_expiration":{"type":"string","nullable":true,"format":"date-time"}}} ``` ### Allowed enum values The following tables list the allowed values for enum fields used in TFV requests. #### UseCaseCategories An array field. List as many categories as applicable. | Value | Description | | ---------------------------------- | ---------------------------------- | | `TWO_FACTOR_AUTHENTICATION` | Two-factor authentication | | `ACCOUNT_NOTIFICATIONS` | Account notifications | | `CUSTOMER_CARE` | Customer care | | `CHARITY_NONPROFIT` | Charity / nonprofit | | `DELIVERY_NOTIFICATIONS` | Delivery notifications | | `FRAUD_ALERT_MESSAGING` | Fraud alert messaging | | `EVENTS` | Events | | `HIGHER_EDUCATION` | Higher education | | `K12` | K-12 education | | `MARKETING` | Marketing | | `POLLING_AND_VOTING_NON_POLITICAL` | Polling and voting (non-political) | | `POLITICAL_ELECTION_CAMPAIGNS` | Political election campaigns | | `PUBLIC_SERVICE_ANNOUNCEMENT` | Public service announcement | | `SECURITY_ALERT` | Security alert | #### BusinessRegistrationAuthority | Value | Description | | ------------------- | ------------------------------------------------------------------ | | `EIN` | Employer Identification Number (US) | | `CBN` | Canadian Business Number (Canada) | | `CRN` | Company Registration Number | | `PROVINCIAL_NUMBER` | Provincial Number (Canada) | | `VAT` | Value Added Tax Number | | `ACN` | Australian Company Number | | `ABN` | Australian Business Number | | `BRN` | Business Registration Number (Hong Kong) | | `SIREN` | Systeme d'Identification du Repertoire des Entreprises (France) | | `SIRET` | Systeme d'Identification du Repertoire des Etablissements (France) | | `NZBN` | New Zealand Business Number | | `USt-IdNr` | Umsatzsteuer-Identifikationsnummer (Germany) | | `CIF` | Certificado de Identificacion Fiscal (Spain) | | `NIF` | Numero de Identificacion Fiscal (Spain/Portugal) | | `CNPJ` | Cadastro Nacional da Pessoa Juridica (Brazil) | | `UID` | Unternehmens-Identifikationsnummer (Switzerland/Austria) | | `NEQ` | Numero d'entreprise du Quebec (Quebec, Canada) | | `OTHER` | Other | #### MessageVolume Estimated monthly volume of messages. | Value | | ------------- | | `10` | | `100` | | `1,000` | | `10,000` | | `100,000` | | `250,000` | | `500,000` | | `750,000` | | `1,000,000` | | `5,000,000` | | `10,000,000+` | ## Submit a TFV request `POST https://messaging.twilio.com/v1/Tollfree/Verifications` ### Request body parameters ```json {"schema":{"type":"object","title":"CreateTollfreeVerificationRequest","required":["BusinessName","BusinessWebsite","NotificationEmail","UseCaseCategories","UseCaseSummary","ProductionMessageSample","OptInImageUrls","OptInType","MessageVolume","TollfreePhoneNumberSid"],"properties":{"BusinessName":{"type":"string","description":"The name of the business or organization using the Tollfree number."},"BusinessWebsite":{"type":"string","description":"The website of the business or organization using the Tollfree number."},"NotificationEmail":{"type":"string","description":"The email address to receive the notification about the verification result. ."},"UseCaseCategories":{"type":"array","nullable":true,"description":"The category of the use case for the Tollfree Number. List as many as are applicable.","refName":"tollfree_verification_enum_use_case_categories","modelName":"tollfree_verification_enum_use_case_categories","items":{"type":"string","enum":["TWO_FACTOR_AUTHENTICATION","ACCOUNT_NOTIFICATIONS","CUSTOMER_CARE","CHARITY_NONPROFIT","DELIVERY_NOTIFICATIONS","FRAUD_ALERT_MESSAGING","EVENTS","HIGHER_EDUCATION","K12","MARKETING","POLLING_AND_VOTING_NON_POLITICAL","POLITICAL_ELECTION_CAMPAIGNS","PUBLIC_SERVICE_ANNOUNCEMENT","SECURITY_ALERT"]}},"UseCaseSummary":{"type":"string","description":"Use this to further explain how messaging is used by the business or organization."},"ProductionMessageSample":{"type":"string","description":"An example of message content, i.e. a sample message."},"OptInImageUrls":{"type":"array","description":"Link to an image that shows the opt-in workflow. Multiple images allowed and must be a publicly hosted URL.","items":{"type":"string"}},"OptInType":{"type":"string","enum":["VERBAL","WEB_FORM","PAPER_FORM","VIA_TEXT","MOBILE_QR_CODE","IMPORT","IMPORT_PLEASE_REPLACE"],"description":"Describe how a user opts-in to text messages.","refName":"tollfree_verification_enum_opt_in_type","modelName":"tollfree_verification_enum_opt_in_type"},"MessageVolume":{"type":"string","description":"Estimate monthly volume of messages from the Tollfree Number."},"TollfreePhoneNumberSid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^PN[0-9a-fA-F]{32}$","description":"The SID of the Phone Number associated with the Tollfree Verification."},"CustomerProfileSid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^BU[0-9a-fA-F]{32}$","description":"Customer's Profile Bundle BundleSid."},"BusinessStreetAddress":{"type":"string","description":"The address of the business or organization using the Tollfree number."},"BusinessStreetAddress2":{"type":"string","description":"The address of the business or organization using the Tollfree number."},"BusinessCity":{"type":"string","description":"The city of the business or organization using the Tollfree number."},"BusinessStateProvinceRegion":{"type":"string","description":"The state/province/region of the business or organization using the Tollfree number."},"BusinessPostalCode":{"type":"string","description":"The postal code of the business or organization using the Tollfree number."},"BusinessCountry":{"type":"string","description":"The country of the business or organization using the Tollfree number."},"AdditionalInformation":{"type":"string","description":"Additional information to be provided for verification."},"BusinessContactFirstName":{"type":"string","description":"The first name of the contact for the business or organization using the Tollfree number."},"BusinessContactLastName":{"type":"string","description":"The last name of the contact for the business or organization using the Tollfree number."},"BusinessContactEmail":{"type":"string","description":"The email address of the contact for the business or organization using the Tollfree number."},"BusinessContactPhone":{"type":"string","format":"phone-number","description":"The E.164 formatted phone number of the contact for the business or organization using the Tollfree number."},"ExternalReferenceId":{"type":"string","description":"An optional external reference ID supplied by customer and echoed back on status retrieval."},"BusinessRegistrationNumber":{"type":"string","description":"A legally recognized business registration number. Required for all business types except SOLE_PROPRIETOR."},"BusinessRegistrationAuthority":{"type":"string","nullable":true,"enum":["EIN","CBN","CRN","PROVINCIAL_NUMBER","VAT","ACN","ABN","BRN","SIREN","SIRET","NZBN","USt-IdNr","CIF","NIF","CNPJ","UID","NEQ","OTHER"],"description":"The organizational authority for business registrations. Required for all business types except SOLE_PROPRIETOR.","refName":"tollfree_verification_enum_business_registration_authority","modelName":"tollfree_verification_enum_business_registration_authority"},"BusinessRegistrationCountry":{"type":"string","description":"The country where the business is registered. Required for all business types except SOLE_PROPRIETOR."},"BusinessType":{"type":"string","enum":["PRIVATE_PROFIT","PUBLIC_PROFIT","SOLE_PROPRIETOR","NON_PROFIT","GOVERNMENT"],"nullable":true,"description":"The type of business, valid values are PRIVATE_PROFIT, PUBLIC_PROFIT, NON_PROFIT, SOLE_PROPRIETOR, GOVERNMENT. Required field.","refName":"tollfree_verification_enum_business_type","modelName":"tollfree_verification_enum_business_type"},"BusinessRegistrationPhoneNumber":{"type":"string","description":"The E.164 formatted number associated with the business."},"DoingBusinessAs":{"type":"string","description":"Trade name, sub entity, or downstream business name of business being submitted for verification"},"OptInConfirmationMessage":{"type":"string","description":"The confirmation message sent to users when they opt in to receive messages."},"HelpMessageSample":{"type":"string","description":"A sample help message provided to users."},"PrivacyPolicyUrl":{"type":"string","description":"The URL to the privacy policy for the business or organization."},"TermsAndConditionsUrl":{"type":"string","description":"The URL to the terms and conditions for the business or organization."},"AgeGatedContent":{"type":"boolean","description":"Indicates if the content is age gated."},"OptInKeywords":{"type":"array","description":"List of keywords that users can text in to opt in to receive messages.","items":{"type":"string"}},"VettingProvider":{"type":"string","nullable":true,"enum":["CAMPAIGN_VERIFY"],"description":"The third-party political vetting provider.","refName":"tollfree_verification_enum_vetting_provider","modelName":"tollfree_verification_enum_vetting_provider"},"VettingId":{"type":"string","description":"The unique ID of the vetting"}}},"examples":{"create":{"value":{"lang":"json","value":"{\n \"BusinessName\": \"Owl, Inc.\",\n \"BusinessStreetAddress\": \"123 Main Street\",\n \"BusinessStreetAddress2\": \"Suite 101\",\n \"BusinessCity\": \"Anytown\",\n \"BusinessStateProvinceRegion\": \"AA\",\n \"BusinessPostalCode\": \"11111\",\n \"BusinessCountry\": \"US\",\n \"BusinessWebsite\": \"http://www.company.com\",\n \"BusinessContactFirstName\": \"firstname\",\n \"BusinessContactLastName\": \"lastname\",\n \"BusinessContactEmail\": \"email@company.com\",\n \"BusinessContactPhone\": \"+11231231234\",\n \"NotificationEmail\": \"support@company.com\",\n \"UseCaseCategories\": [\n \"POLITICAL_ELECTION_CAMPAIGNS\"\n ],\n \"UseCaseSummary\": \"This number is used to send out promotional offers and coupons to the customers of John's Coffee Shop\",\n \"ProductionMessageSample\": \"lorem ipsum\",\n \"OptInImageUrls\": [\n \"https://testbusiness.com/images/image1.jpg\",\n \"https://testbusiness.com/images/image2.jpg\"\n ],\n \"OptInType\": \"VERBAL\",\n \"MessageVolume\": \"10\",\n \"AdditionalInformation\": \"see our privacy policy here www.johnscoffeeshop.com/privacypolicy\",\n \"TollfreePhoneNumberSid\": \"PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"ExternalReferenceId\": \"abc123xyz567\",\n \"BusinessRegistrationNumber\": \"123456789\",\n \"BusinessRegistrationAuthority\": \"EIN\",\n \"BusinessRegistrationCountry\": \"US\",\n \"BusinessType\": \"PRIVATE_PROFIT\",\n \"BusinessRegistrationPhoneNumber\": \"+13023334444\",\n \"DoingBusinessAs\": \"Toms Widgets\",\n \"AgeGatedContent\": false,\n \"HelpMessageSample\": \"For help, reply HELP or visit our website.\",\n \"OptInConfirmationMessage\": \"Thank you for opting in!\",\n \"OptInKeywords\": [\n \"START\"\n ],\n \"PrivacyPolicyUrl\": \"https://www.example.com/privacy\",\n \"TermsAndConditionsUrl\": \"https://www.example.com/terms\",\n \"VettingId\": \"cv|1.0|mno|tfree|a9792599-2156-457a-985b-f9045789b139|osfj78f1qrtue37\",\n \"VettingProvider\": \"CAMPAIGN_VERIFY\"\n}","meta":"","code":"{\n \"BusinessName\": \"Owl, Inc.\",\n \"BusinessStreetAddress\": \"123 Main Street\",\n \"BusinessStreetAddress2\": \"Suite 101\",\n \"BusinessCity\": \"Anytown\",\n \"BusinessStateProvinceRegion\": \"AA\",\n \"BusinessPostalCode\": \"11111\",\n \"BusinessCountry\": \"US\",\n \"BusinessWebsite\": \"http://www.company.com\",\n \"BusinessContactFirstName\": \"firstname\",\n \"BusinessContactLastName\": \"lastname\",\n \"BusinessContactEmail\": \"email@company.com\",\n \"BusinessContactPhone\": \"+11231231234\",\n \"NotificationEmail\": \"support@company.com\",\n \"UseCaseCategories\": [\n \"POLITICAL_ELECTION_CAMPAIGNS\"\n ],\n \"UseCaseSummary\": \"This number is used to send out promotional offers and coupons to the customers of John's Coffee Shop\",\n \"ProductionMessageSample\": \"lorem ipsum\",\n \"OptInImageUrls\": [\n \"https://testbusiness.com/images/image1.jpg\",\n \"https://testbusiness.com/images/image2.jpg\"\n ],\n \"OptInType\": \"VERBAL\",\n \"MessageVolume\": \"10\",\n \"AdditionalInformation\": \"see our privacy policy here www.johnscoffeeshop.com/privacypolicy\",\n \"TollfreePhoneNumberSid\": \"PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"ExternalReferenceId\": \"abc123xyz567\",\n \"BusinessRegistrationNumber\": \"123456789\",\n \"BusinessRegistrationAuthority\": \"EIN\",\n \"BusinessRegistrationCountry\": \"US\",\n \"BusinessType\": \"PRIVATE_PROFIT\",\n \"BusinessRegistrationPhoneNumber\": \"+13023334444\",\n \"DoingBusinessAs\": \"Toms Widgets\",\n \"AgeGatedContent\": false,\n \"HelpMessageSample\": \"For help, reply HELP or visit our website.\",\n \"OptInConfirmationMessage\": \"Thank you for opting in!\",\n \"OptInKeywords\": [\n \"START\"\n ],\n \"PrivacyPolicyUrl\": \"https://www.example.com/privacy\",\n \"TermsAndConditionsUrl\": \"https://www.example.com/terms\",\n \"VettingId\": \"cv|1.0|mno|tfree|a9792599-2156-457a-985b-f9045789b139|osfj78f1qrtue37\",\n \"VettingProvider\": \"CAMPAIGN_VERIFY\"\n}","tokens":[["{","#C9D1D9"],"\n ",["\"BusinessName\"","#7EE787"],[":","#C9D1D9"]," ",["\"Owl, Inc.\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessStreetAddress\"","#7EE787"],[":","#C9D1D9"]," ",["\"123 Main Street\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessStreetAddress2\"","#7EE787"],[":","#C9D1D9"]," ",["\"Suite 101\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessCity\"","#7EE787"],[":","#C9D1D9"]," ",["\"Anytown\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessStateProvinceRegion\"","#7EE787"],[":","#C9D1D9"]," ",["\"AA\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessPostalCode\"","#7EE787"],[":","#C9D1D9"]," ",["\"11111\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessCountry\"","#7EE787"],[":","#C9D1D9"]," ",["\"US\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessWebsite\"","#7EE787"],[":","#C9D1D9"]," ",["\"http://www.company.com\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessContactFirstName\"","#7EE787"],[":","#C9D1D9"]," ",["\"firstname\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessContactLastName\"","#7EE787"],[":","#C9D1D9"]," ",["\"lastname\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessContactEmail\"","#7EE787"],[":","#C9D1D9"]," ",["\"email@company.com\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessContactPhone\"","#7EE787"],[":","#C9D1D9"]," ",["\"+11231231234\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"NotificationEmail\"","#7EE787"],[":","#C9D1D9"]," ",["\"support@company.com\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"UseCaseCategories\"","#7EE787"],[": [","#C9D1D9"],"\n ",["\"POLITICAL_ELECTION_CAMPAIGNS\"","#A5D6FF"],"\n ",["],","#C9D1D9"],"\n ",["\"UseCaseSummary\"","#7EE787"],[":","#C9D1D9"]," ",["\"This number is used to send out promotional offers and coupons to the customers of John's Coffee Shop\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"ProductionMessageSample\"","#7EE787"],[":","#C9D1D9"]," ",["\"lorem ipsum\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"OptInImageUrls\"","#7EE787"],[": [","#C9D1D9"],"\n ",["\"https://testbusiness.com/images/image1.jpg\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"https://testbusiness.com/images/image2.jpg\"","#A5D6FF"],"\n ",["],","#C9D1D9"],"\n ",["\"OptInType\"","#7EE787"],[":","#C9D1D9"]," ",["\"VERBAL\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"MessageVolume\"","#7EE787"],[":","#C9D1D9"]," ",["\"10\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"AdditionalInformation\"","#7EE787"],[":","#C9D1D9"]," ",["\"see our privacy policy here www.johnscoffeeshop.com/privacypolicy\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"TollfreePhoneNumberSid\"","#7EE787"],[":","#C9D1D9"]," ",["\"PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"ExternalReferenceId\"","#7EE787"],[":","#C9D1D9"]," ",["\"abc123xyz567\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessRegistrationNumber\"","#7EE787"],[":","#C9D1D9"]," ",["\"123456789\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessRegistrationAuthority\"","#7EE787"],[":","#C9D1D9"]," ",["\"EIN\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessRegistrationCountry\"","#7EE787"],[":","#C9D1D9"]," ",["\"US\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessType\"","#7EE787"],[":","#C9D1D9"]," ",["\"PRIVATE_PROFIT\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessRegistrationPhoneNumber\"","#7EE787"],[":","#C9D1D9"]," ",["\"+13023334444\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"DoingBusinessAs\"","#7EE787"],[":","#C9D1D9"]," ",["\"Toms Widgets\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"AgeGatedContent\"","#7EE787"],[":","#C9D1D9"]," ",["false","#79C0FF"],[",","#C9D1D9"],"\n ",["\"HelpMessageSample\"","#7EE787"],[":","#C9D1D9"]," ",["\"For help, reply HELP or visit our website.\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"OptInConfirmationMessage\"","#7EE787"],[":","#C9D1D9"]," ",["\"Thank you for opting in!\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"OptInKeywords\"","#7EE787"],[": [","#C9D1D9"],"\n ",["\"START\"","#A5D6FF"],"\n ",["],","#C9D1D9"],"\n ",["\"PrivacyPolicyUrl\"","#7EE787"],[":","#C9D1D9"]," ",["\"https://www.example.com/privacy\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"TermsAndConditionsUrl\"","#7EE787"],[":","#C9D1D9"]," ",["\"https://www.example.com/terms\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"VettingId\"","#7EE787"],[":","#C9D1D9"]," ",["\"cv|1.0|mno|tfree|a9792599-2156-457a-985b-f9045789b139|osfj78f1qrtue37\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"VettingProvider\"","#7EE787"],[":","#C9D1D9"]," ",["\"CAMPAIGN_VERIFY\"","#A5D6FF"],"\n",["}","#C9D1D9"]],"annotations":[],"themeName":"github-dark","style":{"color":"#c9d1d9","background":"#0d1117"}}},"create2":{"value":{"lang":"json","value":"{\n \"CustomerProfileSid\": \"BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"BusinessName\": \"Owl, Inc.\",\n \"BusinessWebsite\": \"http://www.company.com\",\n \"NotificationEmail\": \"support@company.com\",\n \"UseCaseCategories\": [\n \"TWO_FACTOR_AUTHENTICATION\",\n \"MARKETING\"\n ],\n \"UseCaseSummary\": \"This number is used to send out promotional offers and coupons to the customers of John's Coffee Shop\",\n \"ProductionMessageSample\": \"lorem ipsum\",\n \"OptInImageUrls\": [\n \"https://testbusiness.com/images/image1.jpg\",\n \"https://testbusiness.com/images/image2.jpg\"\n ],\n \"OptInType\": \"VERBAL\",\n \"MessageVolume\": \"10\",\n \"AdditionalInformation\": \"see our privacy policy here www.johnscoffeeshop.com/privacypolicy\",\n \"TollfreePhoneNumberSid\": \"PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"ExternalReferenceId\": \"abc123xyz567\",\n \"BusinessRegistrationNumber\": \"123456789\",\n \"BusinessRegistrationAuthority\": \"EIN\",\n \"BusinessRegistrationCountry\": \"US\",\n \"BusinessType\": \"PRIVATE_PROFIT\",\n \"BusinessRegistrationPhoneNumber\": \"+13023334444\",\n \"DoingBusinessAs\": \"Toms Widgets\",\n \"AgeGatedContent\": false,\n \"HelpMessageSample\": \"For help, reply HELP or visit our website.\",\n \"OptInConfirmationMessage\": \"Thank you for opting in!\",\n \"OptInKeywords\": [\n \"START\"\n ],\n \"PrivacyPolicyUrl\": \"https://www.example.com/privacy\",\n \"TermsAndConditionsUrl\": \"https://www.example.com/terms\"\n}","meta":"","code":"{\n \"CustomerProfileSid\": \"BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"BusinessName\": \"Owl, Inc.\",\n \"BusinessWebsite\": \"http://www.company.com\",\n \"NotificationEmail\": \"support@company.com\",\n \"UseCaseCategories\": [\n \"TWO_FACTOR_AUTHENTICATION\",\n \"MARKETING\"\n ],\n \"UseCaseSummary\": \"This number is used to send out promotional offers and coupons to the customers of John's Coffee Shop\",\n \"ProductionMessageSample\": \"lorem ipsum\",\n \"OptInImageUrls\": [\n \"https://testbusiness.com/images/image1.jpg\",\n \"https://testbusiness.com/images/image2.jpg\"\n ],\n \"OptInType\": \"VERBAL\",\n \"MessageVolume\": \"10\",\n \"AdditionalInformation\": \"see our privacy policy here www.johnscoffeeshop.com/privacypolicy\",\n \"TollfreePhoneNumberSid\": \"PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"ExternalReferenceId\": \"abc123xyz567\",\n \"BusinessRegistrationNumber\": \"123456789\",\n \"BusinessRegistrationAuthority\": \"EIN\",\n \"BusinessRegistrationCountry\": \"US\",\n \"BusinessType\": \"PRIVATE_PROFIT\",\n \"BusinessRegistrationPhoneNumber\": \"+13023334444\",\n \"DoingBusinessAs\": \"Toms Widgets\",\n \"AgeGatedContent\": false,\n \"HelpMessageSample\": \"For help, reply HELP or visit our website.\",\n \"OptInConfirmationMessage\": \"Thank you for opting in!\",\n \"OptInKeywords\": [\n \"START\"\n ],\n \"PrivacyPolicyUrl\": \"https://www.example.com/privacy\",\n \"TermsAndConditionsUrl\": \"https://www.example.com/terms\"\n}","tokens":[["{","#C9D1D9"],"\n ",["\"CustomerProfileSid\"","#7EE787"],[":","#C9D1D9"]," ",["\"BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessName\"","#7EE787"],[":","#C9D1D9"]," ",["\"Owl, Inc.\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessWebsite\"","#7EE787"],[":","#C9D1D9"]," ",["\"http://www.company.com\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"NotificationEmail\"","#7EE787"],[":","#C9D1D9"]," ",["\"support@company.com\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"UseCaseCategories\"","#7EE787"],[": [","#C9D1D9"],"\n ",["\"TWO_FACTOR_AUTHENTICATION\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"MARKETING\"","#A5D6FF"],"\n ",["],","#C9D1D9"],"\n ",["\"UseCaseSummary\"","#7EE787"],[":","#C9D1D9"]," ",["\"This number is used to send out promotional offers and coupons to the customers of John's Coffee Shop\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"ProductionMessageSample\"","#7EE787"],[":","#C9D1D9"]," ",["\"lorem ipsum\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"OptInImageUrls\"","#7EE787"],[": [","#C9D1D9"],"\n ",["\"https://testbusiness.com/images/image1.jpg\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"https://testbusiness.com/images/image2.jpg\"","#A5D6FF"],"\n ",["],","#C9D1D9"],"\n ",["\"OptInType\"","#7EE787"],[":","#C9D1D9"]," ",["\"VERBAL\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"MessageVolume\"","#7EE787"],[":","#C9D1D9"]," ",["\"10\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"AdditionalInformation\"","#7EE787"],[":","#C9D1D9"]," ",["\"see our privacy policy here www.johnscoffeeshop.com/privacypolicy\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"TollfreePhoneNumberSid\"","#7EE787"],[":","#C9D1D9"]," ",["\"PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"ExternalReferenceId\"","#7EE787"],[":","#C9D1D9"]," ",["\"abc123xyz567\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessRegistrationNumber\"","#7EE787"],[":","#C9D1D9"]," ",["\"123456789\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessRegistrationAuthority\"","#7EE787"],[":","#C9D1D9"]," ",["\"EIN\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessRegistrationCountry\"","#7EE787"],[":","#C9D1D9"]," ",["\"US\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessType\"","#7EE787"],[":","#C9D1D9"]," ",["\"PRIVATE_PROFIT\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessRegistrationPhoneNumber\"","#7EE787"],[":","#C9D1D9"]," ",["\"+13023334444\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"DoingBusinessAs\"","#7EE787"],[":","#C9D1D9"]," ",["\"Toms Widgets\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"AgeGatedContent\"","#7EE787"],[":","#C9D1D9"]," ",["false","#79C0FF"],[",","#C9D1D9"],"\n ",["\"HelpMessageSample\"","#7EE787"],[":","#C9D1D9"]," ",["\"For help, reply HELP or visit our website.\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"OptInConfirmationMessage\"","#7EE787"],[":","#C9D1D9"]," ",["\"Thank you for opting in!\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"OptInKeywords\"","#7EE787"],[": [","#C9D1D9"],"\n ",["\"START\"","#A5D6FF"],"\n ",["],","#C9D1D9"],"\n ",["\"PrivacyPolicyUrl\"","#7EE787"],[":","#C9D1D9"]," ",["\"https://www.example.com/privacy\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"TermsAndConditionsUrl\"","#7EE787"],[":","#C9D1D9"]," ",["\"https://www.example.com/terms\"","#A5D6FF"],"\n",["}","#C9D1D9"]],"annotations":[],"themeName":"github-dark","style":{"color":"#c9d1d9","background":"#0d1117"}}}},"encodingType":"application/x-www-form-urlencoded","conditionalParameterMap":{}} ``` Submitting a TFV request requires a [Trust Hub Customer Profile][th-customer-profiles]. [th-customer-profiles]: /docs/trust-hub/trusthub-rest-api/customer-profiles ### Submit a TFV request with an existing Customer Profile If you have a Customer Profile, the following API request submits one TFV request associated with your Customer Profile SID. Submit one TFV Request when you have a Customer Profile ```js // Download the helper library from https://www.twilio.com/docs/node/install const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio"; // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure const accountSid = process.env.TWILIO_ACCOUNT_SID; const authToken = process.env.TWILIO_AUTH_TOKEN; const client = twilio(accountSid, authToken); async function createTollfreeVerification() { const tollfreeVerification = await client.messaging.v1.tollfreeVerifications.create({ additionalInformation: "see our privacy policy here www.example.com/privacypolicy", businessName: "Owl, Inc.", businessWebsite: "http://www.example.com", customerProfileSid: "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", externalReferenceId: "abc123xyz567", messageVolume: "10", notificationEmail: "support@example.com", optInImageUrls: [ "https://example.com/images/image1.jpg", "https://example.com/images/image2.jpg", ], optInType: "VERBAL", productionMessageSample: "lorem ipsum", tollfreePhoneNumberSid: "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", useCaseCategories: ["TWO_FACTOR_AUTHENTICATION", "MARKETING"], useCaseSummary: "This number is used to send out promotional offers and coupons to the customers of Owl, Inc.", }); console.log(tollfreeVerification.sid); } createTollfreeVerification(); ``` ```python # Download the helper library from https://www.twilio.com/docs/python/install import os from twilio.rest import Client # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = os.environ["TWILIO_ACCOUNT_SID"] auth_token = os.environ["TWILIO_AUTH_TOKEN"] client = Client(account_sid, auth_token) tollfree_verification = client.messaging.v1.tollfree_verifications.create( customer_profile_sid="BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", business_name="Owl, Inc.", business_website="http://www.example.com", notification_email="support@example.com", use_case_categories=["TWO_FACTOR_AUTHENTICATION", "MARKETING"], use_case_summary="This number is used to send out promotional offers and coupons to the customers of Owl, Inc.", production_message_sample="lorem ipsum", opt_in_image_urls=[ "https://example.com/images/image1.jpg", "https://example.com/images/image2.jpg", ], opt_in_type="VERBAL", message_volume="10", additional_information="see our privacy policy here www.example.com/privacypolicy", tollfree_phone_number_sid="PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", external_reference_id="abc123xyz567", ) print(tollfree_verification.sid) ``` ```csharp // Install the C# / .NET helper library from twilio.com/docs/csharp/install using System; using Twilio; using Twilio.Rest.Messaging.V1; using System.Threading.Tasks; using System.Collections.Generic; class Program { public static async Task Main(string[] args) { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID"); string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN"); TwilioClient.Init(accountSid, authToken); var tollfreeVerification = await TollfreeVerificationResource.CreateAsync( customerProfileSid: "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", businessName: "Owl, Inc.", businessWebsite: "http://www.example.com", notificationEmail: "support@example.com", useCaseCategories: new List { "TWO_FACTOR_AUTHENTICATION", "MARKETING" }, useCaseSummary: "This number is used to send out promotional offers and coupons to the customers of Owl, Inc.", productionMessageSample: "lorem ipsum", optInImageUrls: new List< string> { "https://example.com/images/image1.jpg", "https://example.com/images/image2.jpg" }, optInType: TollfreeVerificationResource.OptInTypeEnum.Verbal, messageVolume: "10", additionalInformation: "see our privacy policy here www.example.com/privacypolicy", tollfreePhoneNumberSid: "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", externalReferenceId: "abc123xyz567"); Console.WriteLine(tollfreeVerification.Sid); } } ``` ```java // Install the Java helper library from twilio.com/docs/java/install import java.util.Arrays; import com.twilio.Twilio; import com.twilio.rest.messaging.v1.TollfreeVerification; public class Example { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID"); public static final String AUTH_TOKEN = System.getenv("TWILIO_AUTH_TOKEN"); public static void main(String[] args) { Twilio.init(ACCOUNT_SID, AUTH_TOKEN); TollfreeVerification tollfreeVerification = TollfreeVerification .creator("Owl, Inc.", "http://www.example.com", "support@example.com", Arrays.asList("TWO_FACTOR_AUTHENTICATION", "MARKETING"), "This number is used to send out promotional offers and coupons to the customers of Owl, Inc.", "lorem ipsum", Arrays.asList("https://example.com/images/image1.jpg", "https://example.com/images/image2.jpg"), TollfreeVerification.OptInType.VERBAL, "10", "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") .setCustomerProfileSid("BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") .setAdditionalInformation("see our privacy policy here www.example.com/privacypolicy") .setExternalReferenceId("abc123xyz567") .create(); System.out.println(tollfreeVerification.getSid()); } } ``` ```go // Download the helper library from https://www.twilio.com/docs/go/install package main import ( "fmt" "github.com/twilio/twilio-go" messaging "github.com/twilio/twilio-go/rest/messaging/v1" "os" ) func main() { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure // Make sure TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN exists in your environment client := twilio.NewRestClient() params := &messaging.CreateTollfreeVerificationParams{} params.SetCustomerProfileSid("BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") params.SetBusinessName("Owl, Inc.") params.SetBusinessWebsite("http://www.example.com") params.SetNotificationEmail("support@example.com") params.SetUseCaseCategories([]string{ "TWO_FACTOR_AUTHENTICATION", "MARKETING", }) params.SetUseCaseSummary("This number is used to send out promotional offers and coupons to the customers of Owl, Inc.") params.SetProductionMessageSample("lorem ipsum") params.SetOptInImageUrls([]string{ "https://example.com/images/image1.jpg", "https://example.com/images/image2.jpg", }) params.SetOptInType("VERBAL") params.SetMessageVolume("10") params.SetAdditionalInformation("see our privacy policy here www.example.com/privacypolicy") params.SetTollfreePhoneNumberSid("PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") params.SetExternalReferenceId("abc123xyz567") resp, err := client.MessagingV1.CreateTollfreeVerification(params) if err != nil { fmt.Println(err.Error()) os.Exit(1) } else { if resp.Sid != nil { fmt.Println(*resp.Sid) } else { fmt.Println(resp.Sid) } } } ``` ```php messaging->v1->tollfreeVerifications->create( "Owl, Inc.", // BusinessName "http://www.example.com", // BusinessWebsite "support@example.com", // NotificationEmail ["TWO_FACTOR_AUTHENTICATION", "MARKETING"], // UseCaseCategories "This number is used to send out promotional offers and coupons to the customers of Owl, Inc.", // UseCaseSummary "lorem ipsum", // ProductionMessageSample [ "https://example.com/images/image1.jpg", "https://example.com/images/image2.jpg", ], // OptInImageUrls "VERBAL", // OptInType "10", // MessageVolume "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", // TollfreePhoneNumberSid [ "customerProfileSid" => "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "additionalInformation" => "see our privacy policy here www.example.com/privacypolicy", "externalReferenceId" => "abc123xyz567", ] ); print $tollfree_verification->sid; ``` ```ruby # Download the helper library from https://www.twilio.com/docs/ruby/install require 'twilio-ruby' # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = ENV['TWILIO_ACCOUNT_SID'] auth_token = ENV['TWILIO_AUTH_TOKEN'] @client = Twilio::REST::Client.new(account_sid, auth_token) tollfree_verification = @client .messaging .v1 .tollfree_verifications .create( customer_profile_sid: 'BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa', business_name: 'Owl, Inc.', business_website: 'http://www.example.com', notification_email: 'support@example.com', use_case_categories: [ 'TWO_FACTOR_AUTHENTICATION', 'MARKETING' ], use_case_summary: 'This number is used to send out promotional offers and coupons to the customers of Owl, Inc.', production_message_sample: 'lorem ipsum', opt_in_image_urls: [ 'https://example.com/images/image1.jpg', 'https://example.com/images/image2.jpg' ], opt_in_type: 'VERBAL', message_volume: '10', additional_information: 'see our privacy policy here www.example.com/privacypolicy', tollfree_phone_number_sid: 'PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa', external_reference_id: 'abc123xyz567' ) puts tollfree_verification.sid ``` ```bash # Install the twilio-cli from https://twil.io/cli twilio api:messaging:v1:tollfree:verifications:create \ --customer-profile-sid BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa \ --business-name "Owl, Inc." \ --business-website http://www.example.com \ --notification-email support@example.com \ --use-case-categories TWO_FACTOR_AUTHENTICATION MARKETING \ --use-case-summary "This number is used to send out promotional offers and coupons to the customers of Owl, Inc." \ --production-message-sample "lorem ipsum" \ --opt-in-image-urls https://example.com/images/image1.jpg https://example.com/images/image2.jpg \ --opt-in-type VERBAL \ --message-volume 10 \ --additional-information "see our privacy policy here www.example.com/privacypolicy" \ --tollfree-phone-number-sid PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa \ --external-reference-id abc123xyz567 ``` ```bash curl -X POST "https://messaging.twilio.com/v1/Tollfree/Verifications" \ --data-urlencode "CustomerProfileSid=BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \ --data-urlencode "BusinessName=Owl, Inc." \ --data-urlencode "BusinessWebsite=http://www.example.com" \ --data-urlencode "NotificationEmail=support@example.com" \ --data-urlencode "UseCaseCategories=TWO_FACTOR_AUTHENTICATION" \ --data-urlencode "UseCaseCategories=MARKETING" \ --data-urlencode "UseCaseSummary=This number is used to send out promotional offers and coupons to the customers of Owl, Inc." \ --data-urlencode "ProductionMessageSample=lorem ipsum" \ --data-urlencode "OptInImageUrls=https://example.com/images/image1.jpg" \ --data-urlencode "OptInImageUrls=https://example.com/images/image2.jpg" \ --data-urlencode "OptInType=VERBAL" \ --data-urlencode "MessageVolume=10" \ --data-urlencode "AdditionalInformation=see our privacy policy here www.example.com/privacypolicy" \ --data-urlencode "TollfreePhoneNumberSid=PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \ --data-urlencode "ExternalReferenceId=abc123xyz567" \ -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN ``` ```json { "sid": "HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "customer_profile_sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "regulated_item_sid": null, "trust_product_sid": null, "business_name": "Owl, Inc.", "status": "PENDING_REVIEW", "date_created": "2021-01-27T14:18:35Z", "date_updated": "2021-01-27T14:18:36Z", "business_street_address": "123 Main Street", "business_street_address2": "Suite 101", "business_city": "Anytown", "business_state_province_region": "AA", "business_postal_code": "11111", "business_country": "US", "business_website": "http://www.example.com", "business_contact_first_name": "firstname", "business_contact_last_name": "lastname", "business_contact_email": "email@company.com", "business_contact_phone": "+11231231234", "notification_email": "support@example.com", "use_case_categories": [ "TWO_FACTOR_AUTHENTICATION", "MARKETING" ], "use_case_summary": "This number is used to send out promotional offers and coupons to the customers of Owl, Inc.", "production_message_sample": "lorem ipsum", "opt_in_image_urls": [ "https://example.com/images/image1.jpg", "https://example.com/images/image2.jpg" ], "opt_in_type": "VERBAL", "message_volume": "10", "additional_information": "see our privacy policy here www.example.com/privacypolicy", "tollfree_phone_number_sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "rejection_reason": null, "error_code": null, "edit_expiration": null, "edit_allowed": null, "rejection_reasons": null, "resource_links": {}, "url": "https://messaging.twilio.com/v1/Tollfree/Verifications/HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "external_reference_id": "abc123xyz567", "business_registration_number": "123456789", "business_registration_authority": "EIN", "business_registration_country": "US", "business_type": "PRIVATE_PROFIT", "business_registration_phone_number": "+13023334444", "doing_business_as": "Toms Widgets", "age_gated_content": false, "help_message_sample": "For help, reply HELP or visit our website.", "opt_in_confirmation_message": "Thank you for opting in!", "opt_in_keywords": [ "START" ], "privacy_policy_url": "https://www.example.com/privacy", "terms_and_conditions_url": "https://www.example.com/terms", "tollfree_phone_number": "+18003334444", "vetting_id": null, "vetting_id_expiration": null, "vetting_provider": null } ``` ### Submit a TFV request without an existing Customer Profile If you don't have a Trust Hub Customer Profile, the following API request creates a Customer Profile *and* submits one TFV request for that profile. Submit one TFV Request when you don't have a Customer Profile ```js // Download the helper library from https://www.twilio.com/docs/node/install const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio"; // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure const accountSid = process.env.TWILIO_ACCOUNT_SID; const authToken = process.env.TWILIO_AUTH_TOKEN; const client = twilio(accountSid, authToken); async function createTollfreeVerification() { const tollfreeVerification = await client.messaging.v1.tollfreeVerifications.create({ additionalInformation: "see our privacy policy here www.example.com/privacypolicy", businessCity: "Anytown", businessContactEmail: "email@example.com", businessContactFirstName: "firstname", businessContactLastName: "lastname", businessContactPhone: "+1231231234", businessCountry: "US", businessName: "Owl, Inc.", businessPostalCode: "11111", businessStateProvinceRegion: "AA", businessStreetAddress: "123 Main Street", businessStreetAddress2: "Suite 101", businessWebsite: "http://www.example.com", externalReferenceId: "abc123xyz567", messageVolume: "10", notificationEmail: "support@example.com", optInImageUrls: [ "https://example.com/images/image1.jpg", "https://example.com/images/image2.jpg", ], optInType: "VERBAL", productionMessageSample: "lorem ipsum", tollfreePhoneNumberSid: "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", useCaseCategories: ["TWO_FACTOR_AUTHENTICATION", "MARKETING"], useCaseSummary: "This number is used to send out promotional offers and coupons to the customers of John's Coffee Shop", }); console.log(tollfreeVerification.sid); } createTollfreeVerification(); ``` ```python # Download the helper library from https://www.twilio.com/docs/python/install import os from twilio.rest import Client # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = os.environ["TWILIO_ACCOUNT_SID"] auth_token = os.environ["TWILIO_AUTH_TOKEN"] client = Client(account_sid, auth_token) tollfree_verification = client.messaging.v1.tollfree_verifications.create( business_name="Owl, Inc.", business_street_address="123 Main Street", business_street_address2="Suite 101", business_city="Anytown", business_state_province_region="AA", business_postal_code="11111", business_country="US", business_website="http://www.example.com", business_contact_first_name="firstname", business_contact_last_name="lastname", business_contact_email="email@example.com", business_contact_phone="+1231231234", notification_email="support@example.com", use_case_categories=["TWO_FACTOR_AUTHENTICATION", "MARKETING"], use_case_summary="This number is used to send out promotional offers and coupons to the customers of John's Coffee Shop", production_message_sample="lorem ipsum", opt_in_image_urls=[ "https://example.com/images/image1.jpg", "https://example.com/images/image2.jpg", ], opt_in_type="VERBAL", message_volume="10", additional_information="see our privacy policy here www.example.com/privacypolicy", tollfree_phone_number_sid="PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", external_reference_id="abc123xyz567", ) print(tollfree_verification.sid) ``` ```csharp // Install the C# / .NET helper library from twilio.com/docs/csharp/install using System; using Twilio; using Twilio.Rest.Messaging.V1; using System.Threading.Tasks; using System.Collections.Generic; class Program { public static async Task Main(string[] args) { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID"); string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN"); TwilioClient.Init(accountSid, authToken); var tollfreeVerification = await TollfreeVerificationResource.CreateAsync( businessName: "Owl, Inc.", businessStreetAddress: "123 Main Street", businessStreetAddress2: "Suite 101", businessCity: "Anytown", businessStateProvinceRegion: "AA", businessPostalCode: "11111", businessCountry: "US", businessWebsite: "http://www.example.com", businessContactFirstName: "firstname", businessContactLastName: "lastname", businessContactEmail: "email@example.com", businessContactPhone: new Twilio.Types.PhoneNumber("+1231231234"), notificationEmail: "support@example.com", useCaseCategories: new List { "TWO_FACTOR_AUTHENTICATION", "MARKETING" }, useCaseSummary: "This number is used to send out promotional offers and coupons to the customers of John's Coffee Shop", productionMessageSample: "lorem ipsum", optInImageUrls: new List< string> { "https://example.com/images/image1.jpg", "https://example.com/images/image2.jpg" }, optInType: TollfreeVerificationResource.OptInTypeEnum.Verbal, messageVolume: "10", additionalInformation: "see our privacy policy here www.example.com/privacypolicy", tollfreePhoneNumberSid: "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", externalReferenceId: "abc123xyz567"); Console.WriteLine(tollfreeVerification.Sid); } } ``` ```java // Install the Java helper library from twilio.com/docs/java/install import com.twilio.type.PhoneNumber; import java.util.Arrays; import com.twilio.Twilio; import com.twilio.rest.messaging.v1.TollfreeVerification; public class Example { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID"); public static final String AUTH_TOKEN = System.getenv("TWILIO_AUTH_TOKEN"); public static void main(String[] args) { Twilio.init(ACCOUNT_SID, AUTH_TOKEN); TollfreeVerification tollfreeVerification = TollfreeVerification .creator("Owl, Inc.", "http://www.example.com", "support@example.com", Arrays.asList("TWO_FACTOR_AUTHENTICATION", "MARKETING"), "This number is used to send out promotional offers and coupons to the customers of John's Coffee " + "Shop", "lorem ipsum", Arrays.asList("https://example.com/images/image1.jpg", "https://example.com/images/image2.jpg"), TollfreeVerification.OptInType.VERBAL, "10", "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") .setBusinessStreetAddress("123 Main Street") .setBusinessStreetAddress2("Suite 101") .setBusinessCity("Anytown") .setBusinessStateProvinceRegion("AA") .setBusinessPostalCode("11111") .setBusinessCountry("US") .setBusinessContactFirstName("firstname") .setBusinessContactLastName("lastname") .setBusinessContactEmail("email@example.com") .setBusinessContactPhone(new com.twilio.type.PhoneNumber("+1231231234")) .setAdditionalInformation("see our privacy policy here www.example.com/privacypolicy") .setExternalReferenceId("abc123xyz567") .create(); System.out.println(tollfreeVerification.getSid()); } } ``` ```go // Download the helper library from https://www.twilio.com/docs/go/install package main import ( "fmt" "github.com/twilio/twilio-go" messaging "github.com/twilio/twilio-go/rest/messaging/v1" "os" ) func main() { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure // Make sure TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN exists in your environment client := twilio.NewRestClient() params := &messaging.CreateTollfreeVerificationParams{} params.SetBusinessName("Owl, Inc.") params.SetBusinessStreetAddress("123 Main Street") params.SetBusinessStreetAddress2("Suite 101") params.SetBusinessCity("Anytown") params.SetBusinessStateProvinceRegion("AA") params.SetBusinessPostalCode("11111") params.SetBusinessCountry("US") params.SetBusinessWebsite("http://www.example.com") params.SetBusinessContactFirstName("firstname") params.SetBusinessContactLastName("lastname") params.SetBusinessContactEmail("email@example.com") params.SetBusinessContactPhone("+1231231234") params.SetNotificationEmail("support@example.com") params.SetUseCaseCategories([]string{ "TWO_FACTOR_AUTHENTICATION", "MARKETING", }) params.SetUseCaseSummary("This number is used to send out promotional offers and coupons to the customers of John's Coffee Shop") params.SetProductionMessageSample("lorem ipsum") params.SetOptInImageUrls([]string{ "https://example.com/images/image1.jpg", "https://example.com/images/image2.jpg", }) params.SetOptInType("VERBAL") params.SetMessageVolume("10") params.SetAdditionalInformation("see our privacy policy here www.example.com/privacypolicy") params.SetTollfreePhoneNumberSid("PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") params.SetExternalReferenceId("abc123xyz567") resp, err := client.MessagingV1.CreateTollfreeVerification(params) if err != nil { fmt.Println(err.Error()) os.Exit(1) } else { if resp.Sid != nil { fmt.Println(*resp.Sid) } else { fmt.Println(resp.Sid) } } } ``` ```php messaging->v1->tollfreeVerifications->create( "Owl, Inc.", // BusinessName "http://www.example.com", // BusinessWebsite "support@example.com", // NotificationEmail ["TWO_FACTOR_AUTHENTICATION", "MARKETING"], // UseCaseCategories "This number is used to send out promotional offers and coupons to the customers of John's Coffee Shop", // UseCaseSummary "lorem ipsum", // ProductionMessageSample [ "https://example.com/images/image1.jpg", "https://example.com/images/image2.jpg", ], // OptInImageUrls "VERBAL", // OptInType "10", // MessageVolume "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", // TollfreePhoneNumberSid [ "businessStreetAddress" => "123 Main Street", "businessStreetAddress2" => "Suite 101", "businessCity" => "Anytown", "businessStateProvinceRegion" => "AA", "businessPostalCode" => "11111", "businessCountry" => "US", "businessContactFirstName" => "firstname", "businessContactLastName" => "lastname", "businessContactEmail" => "email@example.com", "businessContactPhone" => "+1231231234", "additionalInformation" => "see our privacy policy here www.example.com/privacypolicy", "externalReferenceId" => "abc123xyz567", ] ); print $tollfree_verification->sid; ``` ```ruby # Download the helper library from https://www.twilio.com/docs/ruby/install require 'twilio-ruby' # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = ENV['TWILIO_ACCOUNT_SID'] auth_token = ENV['TWILIO_AUTH_TOKEN'] @client = Twilio::REST::Client.new(account_sid, auth_token) tollfree_verification = @client .messaging .v1 .tollfree_verifications .create( business_name: 'Owl, Inc.', business_street_address: '123 Main Street', business_street_address2: 'Suite 101', business_city: 'Anytown', business_state_province_region: 'AA', business_postal_code: '11111', business_country: 'US', business_website: 'http://www.example.com', business_contact_first_name: 'firstname', business_contact_last_name: 'lastname', business_contact_email: 'email@example.com', business_contact_phone: '+1231231234', notification_email: 'support@example.com', use_case_categories: [ 'TWO_FACTOR_AUTHENTICATION', 'MARKETING' ], use_case_summary: 'This number is used to send out promotional offers and coupons to the customers of John\'s Coffee Shop', production_message_sample: 'lorem ipsum', opt_in_image_urls: [ 'https://example.com/images/image1.jpg', 'https://example.com/images/image2.jpg' ], opt_in_type: 'VERBAL', message_volume: '10', additional_information: 'see our privacy policy here www.example.com/privacypolicy', tollfree_phone_number_sid: 'PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa', external_reference_id: 'abc123xyz567' ) puts tollfree_verification.sid ``` ```bash # Install the twilio-cli from https://twil.io/cli twilio api:messaging:v1:tollfree:verifications:create \ --business-name "Owl, Inc." \ --business-street-address "123 Main Street" \ --business-street-address2 "Suite 101" \ --business-city Anytown \ --business-state-province-region AA \ --business-postal-code 11111 \ --business-country US \ --business-website http://www.example.com \ --business-contact-first-name firstname \ --business-contact-last-name lastname \ --business-contact-email email@example.com \ --business-contact-phone +1231231234 \ --notification-email support@example.com \ --use-case-categories TWO_FACTOR_AUTHENTICATION MARKETING \ --use-case-summary "This number is used to send out promotional offers and coupons to the customers of John's Coffee Shop" \ --production-message-sample "lorem ipsum" \ --opt-in-image-urls https://example.com/images/image1.jpg https://example.com/images/image2.jpg \ --opt-in-type VERBAL \ --message-volume 10 \ --additional-information "see our privacy policy here www.example.com/privacypolicy" \ --tollfree-phone-number-sid PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa \ --external-reference-id abc123xyz567 ``` ```bash curl -X POST "https://messaging.twilio.com/v1/Tollfree/Verifications" \ --data-urlencode "BusinessName=Owl, Inc." \ --data-urlencode "BusinessStreetAddress=123 Main Street" \ --data-urlencode "BusinessStreetAddress2=Suite 101" \ --data-urlencode "BusinessCity=Anytown" \ --data-urlencode "BusinessStateProvinceRegion=AA" \ --data-urlencode "BusinessPostalCode=11111" \ --data-urlencode "BusinessCountry=US" \ --data-urlencode "BusinessWebsite=http://www.example.com" \ --data-urlencode "BusinessContactFirstName=firstname" \ --data-urlencode "BusinessContactLastName=lastname" \ --data-urlencode "BusinessContactEmail=email@example.com" \ --data-urlencode "BusinessContactPhone=+1231231234" \ --data-urlencode "NotificationEmail=support@example.com" \ --data-urlencode "UseCaseCategories=TWO_FACTOR_AUTHENTICATION" \ --data-urlencode "UseCaseCategories=MARKETING" \ --data-urlencode "UseCaseSummary=This number is used to send out promotional offers and coupons to the customers of John's Coffee Shop" \ --data-urlencode "ProductionMessageSample=lorem ipsum" \ --data-urlencode "OptInImageUrls=https://example.com/images/image1.jpg" \ --data-urlencode "OptInImageUrls=https://example.com/images/image2.jpg" \ --data-urlencode "OptInType=VERBAL" \ --data-urlencode "MessageVolume=10" \ --data-urlencode "AdditionalInformation=see our privacy policy here www.example.com/privacypolicy" \ --data-urlencode "TollfreePhoneNumberSid=PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \ --data-urlencode "ExternalReferenceId=abc123xyz567" \ -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN ``` ```json { "sid": "HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "regulated_item_sid": null, "customer_profile_sid": null, "trust_product_sid": null, "status": "PENDING_REVIEW", "date_created": "2021-01-27T14:18:35Z", "date_updated": "2021-01-27T14:18:36Z", "business_name": "Owl, Inc.", "business_street_address": "123 Main Street", "business_street_address2": "Suite 101", "business_city": "Anytown", "business_state_province_region": "AA", "business_postal_code": "11111", "business_country": "US", "business_website": "http://www.example.com", "business_contact_first_name": "firstname", "business_contact_last_name": "lastname", "business_contact_email": "email@example.com", "business_contact_phone": "+1231231234", "notification_email": "support@example.com", "use_case_categories": [ "TWO_FACTOR_AUTHENTICATION", "MARKETING" ], "use_case_summary": "This number is used to send out promotional offers and coupons to the customers of John's Coffee Shop", "production_message_sample": "lorem ipsum", "opt_in_image_urls": [ "https://example.com/images/image1.jpg", "https://example.com/images/image2.jpg" ], "opt_in_type": "VERBAL", "message_volume": "10", "additional_information": "see our privacy policy here www.example.com/privacypolicy", "tollfree_phone_number_sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "rejection_reason": null, "error_code": null, "edit_expiration": null, "edit_allowed": null, "rejection_reasons": null, "resource_links": {}, "url": "https://messaging.twilio.com/v1/Tollfree/Verifications/HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "external_reference_id": "abc123xyz567", "business_registration_number": "123456789", "business_registration_authority": "EIN", "business_registration_country": "US", "business_type": "PRIVATE_PROFIT", "business_registration_phone_number": "+13023334444", "doing_business_as": "Toms Widgets", "age_gated_content": false, "help_message_sample": "For help, reply HELP or visit our website.", "opt_in_confirmation_message": "Thank you for opting in!", "opt_in_keywords": [ "START" ], "privacy_policy_url": "https://www.example.com/privacy", "terms_and_conditions_url": "https://www.example.com/terms", "tollfree_phone_number": "+18003334444", "vetting_id": null, "vetting_id_expiration": null, "vetting_provider": null } ``` ## Retrieve a TFV request `GET https://messaging.twilio.com/v1/Tollfree/Verifications/{Sid}` ### Path parameters ```json [{"name":"Sid","in":"path","description":"A unique string identifying a Tollfree Verification.","schema":{"type":"string","minLength":34,"maxLength":34,"pattern":"^HH[0-9a-fA-F]{32}$"},"required":true}] ``` Retrieve a TFV request ```js // Download the helper library from https://www.twilio.com/docs/node/install const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio"; // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure const accountSid = process.env.TWILIO_ACCOUNT_SID; const authToken = process.env.TWILIO_AUTH_TOKEN; const client = twilio(accountSid, authToken); async function fetchTollfreeVerification() { const tollfreeVerification = await client.messaging.v1 .tollfreeVerifications("HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") .fetch(); console.log(tollfreeVerification.sid); } fetchTollfreeVerification(); ``` ```python # Download the helper library from https://www.twilio.com/docs/python/install import os from twilio.rest import Client # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = os.environ["TWILIO_ACCOUNT_SID"] auth_token = os.environ["TWILIO_AUTH_TOKEN"] client = Client(account_sid, auth_token) tollfree_verification = client.messaging.v1.tollfree_verifications( "HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" ).fetch() print(tollfree_verification.sid) ``` ```csharp // Install the C# / .NET helper library from twilio.com/docs/csharp/install using System; using Twilio; using Twilio.Rest.Messaging.V1; using System.Threading.Tasks; class Program { public static async Task Main(string[] args) { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID"); string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN"); TwilioClient.Init(accountSid, authToken); var tollfreeVerification = await TollfreeVerificationResource.FetchAsync( pathSid: "HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"); Console.WriteLine(tollfreeVerification.Sid); } } ``` ```java // Install the Java helper library from twilio.com/docs/java/install import com.twilio.Twilio; import com.twilio.rest.messaging.v1.TollfreeVerification; public class Example { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID"); public static final String AUTH_TOKEN = System.getenv("TWILIO_AUTH_TOKEN"); public static void main(String[] args) { Twilio.init(ACCOUNT_SID, AUTH_TOKEN); TollfreeVerification tollfreeVerification = TollfreeVerification.fetcher("HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa").fetch(); System.out.println(tollfreeVerification.getSid()); } } ``` ```go // Download the helper library from https://www.twilio.com/docs/go/install package main import ( "fmt" "github.com/twilio/twilio-go" "os" ) func main() { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure // Make sure TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN exists in your environment client := twilio.NewRestClient() resp, err := client.MessagingV1.FetchTollfreeVerification("HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") if err != nil { fmt.Println(err.Error()) os.Exit(1) } else { if resp.Sid != nil { fmt.Println(*resp.Sid) } else { fmt.Println(resp.Sid) } } } ``` ```php messaging->v1 ->tollfreeVerifications("HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") ->fetch(); print $tollfree_verification->sid; ``` ```ruby # Download the helper library from https://www.twilio.com/docs/ruby/install require 'twilio-ruby' # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = ENV['TWILIO_ACCOUNT_SID'] auth_token = ENV['TWILIO_AUTH_TOKEN'] @client = Twilio::REST::Client.new(account_sid, auth_token) tollfree_verification = @client .messaging .v1 .tollfree_verifications('HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa') .fetch puts tollfree_verification.sid ``` ```bash # Install the twilio-cli from https://twil.io/cli twilio api:messaging:v1:tollfree:verifications:fetch \ --sid HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa ``` ```bash curl -X GET "https://messaging.twilio.com/v1/Tollfree/Verifications/HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \ -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN ``` ```json { "sid": "HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "customer_profile_sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "trust_product_sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "regulated_item_sid": "RAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "date_created": "2021-01-27T14:18:35Z", "date_updated": "2021-01-27T14:18:36Z", "business_name": "Owl, Inc.", "business_street_address": "123 Main Street", "business_street_address2": "Suite 101", "business_city": "Anytown", "business_state_province_region": "AA", "business_postal_code": "11111", "business_country": "US", "business_website": "http://www.company.com", "business_contact_first_name": "firstname", "business_contact_last_name": "lastname", "business_contact_email": "email@company.com", "business_contact_phone": "+11231231234", "notification_email": "support@company.com", "use_case_categories": [ "TWO_FACTOR_AUTHENTICATION", "MARKETING" ], "use_case_summary": "This number is used to send out promotional offers and coupons to the customers of John's Coffee Shop", "production_message_sample": "lorem ipsum", "opt_in_image_urls": [ "https://testbusiness.com/images/image1.jpg", "https://testbusiness.com/images/image2.jpg" ], "opt_in_type": "VERBAL", "message_volume": "2000", "additional_information": "see our privacy policy here www.johnscoffeeshop.com/privacypolicy", "tollfree_phone_number_sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "status": "TWILIO_APPROVED", "rejection_reason": null, "error_code": null, "edit_expiration": null, "edit_allowed": null, "rejection_reasons": null, "resource_links": { "customer_profile": "https://trusthub.twilio.com/v1/CustomerProfiles/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "trust_product": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "channel_endpoint_assignment": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelEndpointAssignments/RAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" }, "url": "https://messaging.twilio.com/v1/Tollfree/Verifications/HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "external_reference_id": "abc123xyz567", "business_registration_number": "123456789", "business_registration_authority": "EIN", "business_registration_country": "US", "business_type": "PRIVATE_PROFIT", "business_registration_phone_number": "+13023334444", "doing_business_as": "Toms Widgets", "age_gated_content": false, "help_message_sample": "For help, reply HELP or visit our website.", "opt_in_confirmation_message": "Thank you for opting in!", "opt_in_keywords": [ "START" ], "privacy_policy_url": "https://www.example.com/privacy", "terms_and_conditions_url": "https://www.example.com/terms", "tollfree_phone_number": "+18003334444", "vetting_id": null, "vetting_id_expiration": null, "vetting_provider": null } ``` ## Retrieve a list of TFV requests `GET https://messaging.twilio.com/v1/Tollfree/Verifications` ### Query parameters ```json [{"name":"TollfreePhoneNumberSid","in":"query","description":"The SID of the Phone Number associated with the Tollfree Verification.","schema":{"type":"string","minLength":34,"maxLength":34,"pattern":"^PN[0-9a-fA-F]{32}$"},"examples":{"read":{"value":"PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}}},{"name":"Status","in":"query","description":"The compliance status of the Tollfree Verification record.","schema":{"type":"string","enum":["PENDING_REVIEW","IN_REVIEW","TWILIO_APPROVED","TWILIO_REJECTED"],"description":"The compliance status of the Tollfree Verification record.","refName":"tollfree_verification_enum_status","modelName":"tollfree_verification_enum_status"},"examples":{"read":{"value":"TWILIO_APPROVED"}}},{"name":"ExternalReferenceId","in":"query","description":"Customer supplied reference id for the Tollfree Verification record.","schema":{"type":"string"},"examples":{"read":{"value":"abc123xyz567"}}},{"name":"IncludeSubAccounts","in":"query","description":"Whether to include Tollfree Verifications from sub accounts in list response.","schema":{"type":"boolean"},"examples":{"read":{"value":false}}},{"name":"PageSize","in":"query","description":"How many resources to return in each list page. The default is 50, and the maximum is 1000.","schema":{"type":"integer","format":"int64","minimum":1,"maximum":1000}},{"name":"Page","in":"query","description":"The page index. This value is simply for client state.","schema":{"type":"integer","minimum":0}},{"name":"PageToken","in":"query","description":"The page token. This is provided by the API.","schema":{"type":"string"}},{"name":"TrustProductSid","in":"query","description":"The trust product sids / tollfree bundle sids of tollfree verifications","schema":{"type":"array","items":{"type":"string"}}}] ``` Retrieve a list of TFV requests ```js // Download the helper library from https://www.twilio.com/docs/node/install const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio"; // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure const accountSid = process.env.TWILIO_ACCOUNT_SID; const authToken = process.env.TWILIO_AUTH_TOKEN; const client = twilio(accountSid, authToken); async function fetchTollfreeVerification() { const tollfreeVerification = await client.messaging.v1 .tollfreeVerifications("HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") .fetch(); console.log(tollfreeVerification.sid); } fetchTollfreeVerification(); ``` ```python # Download the helper library from https://www.twilio.com/docs/python/install import os from twilio.rest import Client # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = os.environ["TWILIO_ACCOUNT_SID"] auth_token = os.environ["TWILIO_AUTH_TOKEN"] client = Client(account_sid, auth_token) tollfree_verification = client.messaging.v1.tollfree_verifications( "HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" ).fetch() print(tollfree_verification.sid) ``` ```csharp // Install the C# / .NET helper library from twilio.com/docs/csharp/install using System; using Twilio; using Twilio.Rest.Messaging.V1; using System.Threading.Tasks; class Program { public static async Task Main(string[] args) { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID"); string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN"); TwilioClient.Init(accountSid, authToken); var tollfreeVerification = await TollfreeVerificationResource.FetchAsync( pathSid: "HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"); Console.WriteLine(tollfreeVerification.Sid); } } ``` ```java // Install the Java helper library from twilio.com/docs/java/install import com.twilio.Twilio; import com.twilio.rest.messaging.v1.TollfreeVerification; public class Example { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID"); public static final String AUTH_TOKEN = System.getenv("TWILIO_AUTH_TOKEN"); public static void main(String[] args) { Twilio.init(ACCOUNT_SID, AUTH_TOKEN); TollfreeVerification tollfreeVerification = TollfreeVerification.fetcher("HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa").fetch(); System.out.println(tollfreeVerification.getSid()); } } ``` ```go // Download the helper library from https://www.twilio.com/docs/go/install package main import ( "fmt" "github.com/twilio/twilio-go" "os" ) func main() { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure // Make sure TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN exists in your environment client := twilio.NewRestClient() resp, err := client.MessagingV1.FetchTollfreeVerification("HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") if err != nil { fmt.Println(err.Error()) os.Exit(1) } else { if resp.Sid != nil { fmt.Println(*resp.Sid) } else { fmt.Println(resp.Sid) } } } ``` ```php messaging->v1 ->tollfreeVerifications("HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") ->fetch(); print $tollfree_verification->sid; ``` ```ruby # Download the helper library from https://www.twilio.com/docs/ruby/install require 'twilio-ruby' # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = ENV['TWILIO_ACCOUNT_SID'] auth_token = ENV['TWILIO_AUTH_TOKEN'] @client = Twilio::REST::Client.new(account_sid, auth_token) tollfree_verification = @client .messaging .v1 .tollfree_verifications('HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa') .fetch puts tollfree_verification.sid ``` ```bash # Install the twilio-cli from https://twil.io/cli twilio api:messaging:v1:tollfree:verifications:fetch \ --sid HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa ``` ```bash curl -X GET "https://messaging.twilio.com/v1/Tollfree/Verifications/HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \ -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN ``` ```json { "sid": "HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "customer_profile_sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "trust_product_sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "regulated_item_sid": "RAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "date_created": "2021-01-27T14:18:35Z", "date_updated": "2021-01-27T14:18:36Z", "business_name": "Owl, Inc.", "business_street_address": "123 Main Street", "business_street_address2": "Suite 101", "business_city": "Anytown", "business_state_province_region": "AA", "business_postal_code": "11111", "business_country": "US", "business_website": "http://www.company.com", "business_contact_first_name": "firstname", "business_contact_last_name": "lastname", "business_contact_email": "email@company.com", "business_contact_phone": "+11231231234", "notification_email": "support@company.com", "use_case_categories": [ "TWO_FACTOR_AUTHENTICATION", "MARKETING" ], "use_case_summary": "This number is used to send out promotional offers and coupons to the customers of John's Coffee Shop", "production_message_sample": "lorem ipsum", "opt_in_image_urls": [ "https://testbusiness.com/images/image1.jpg", "https://testbusiness.com/images/image2.jpg" ], "opt_in_type": "VERBAL", "message_volume": "2000", "additional_information": "see our privacy policy here www.johnscoffeeshop.com/privacypolicy", "tollfree_phone_number_sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "status": "TWILIO_APPROVED", "rejection_reason": null, "error_code": null, "edit_expiration": null, "edit_allowed": null, "rejection_reasons": null, "resource_links": { "customer_profile": "https://trusthub.twilio.com/v1/CustomerProfiles/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "trust_product": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "channel_endpoint_assignment": "https://trusthub.twilio.com/v1/TrustProducts/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelEndpointAssignments/RAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" }, "url": "https://messaging.twilio.com/v1/Tollfree/Verifications/HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "external_reference_id": "abc123xyz567", "business_registration_number": "123456789", "business_registration_authority": "EIN", "business_registration_country": "US", "business_type": "PRIVATE_PROFIT", "business_registration_phone_number": "+13023334444", "doing_business_as": "Toms Widgets", "age_gated_content": false, "help_message_sample": "For help, reply HELP or visit our website.", "opt_in_confirmation_message": "Thank you for opting in!", "opt_in_keywords": [ "START" ], "privacy_policy_url": "https://www.example.com/privacy", "terms_and_conditions_url": "https://www.example.com/terms", "tollfree_phone_number": "+18003334444", "vetting_id": null, "vetting_id_expiration": null, "vetting_provider": null } ``` ## Update a TFV request `POST https://messaging.twilio.com/v1/Tollfree/Verifications/{Sid}` ### Path parameters ```json [{"name":"Sid","in":"path","description":"The unique string to identify Tollfree Verification.","schema":{"type":"string","minLength":34,"maxLength":34,"pattern":"^HH[0-9a-fA-F]{32}$"},"required":true}] ``` ### Request body parameters ```json {"schema":{"type":"object","title":"UpdateTollfreeVerificationRequest","properties":{"BusinessName":{"type":"string","description":"The name of the business or organization using the Tollfree number."},"BusinessWebsite":{"type":"string","description":"The website of the business or organization using the Tollfree number."},"NotificationEmail":{"type":"string","description":"The email address to receive the notification about the verification result. ."},"UseCaseCategories":{"type":"array","nullable":true,"description":"The category of the use case for the Tollfree Number. List as many as are applicable.","refName":"tollfree_verification_enum_use_case_categories","modelName":"tollfree_verification_enum_use_case_categories","items":{"type":"string","enum":["TWO_FACTOR_AUTHENTICATION","ACCOUNT_NOTIFICATIONS","CUSTOMER_CARE","CHARITY_NONPROFIT","DELIVERY_NOTIFICATIONS","FRAUD_ALERT_MESSAGING","EVENTS","HIGHER_EDUCATION","K12","MARKETING","POLLING_AND_VOTING_NON_POLITICAL","POLITICAL_ELECTION_CAMPAIGNS","PUBLIC_SERVICE_ANNOUNCEMENT","SECURITY_ALERT"]}},"UseCaseSummary":{"type":"string","description":"Use this to further explain how messaging is used by the business or organization."},"ProductionMessageSample":{"type":"string","description":"An example of message content, i.e. a sample message."},"OptInImageUrls":{"type":"array","description":"Link to an image that shows the opt-in workflow. Multiple images allowed and must be a publicly hosted URL.","items":{"type":"string"}},"OptInType":{"type":"string","enum":["VERBAL","WEB_FORM","PAPER_FORM","VIA_TEXT","MOBILE_QR_CODE","IMPORT","IMPORT_PLEASE_REPLACE"],"description":"Describe how a user opts-in to text messages.","refName":"tollfree_verification_enum_opt_in_type","modelName":"tollfree_verification_enum_opt_in_type"},"MessageVolume":{"type":"string","description":"Estimate monthly volume of messages from the Tollfree Number."},"BusinessStreetAddress":{"type":"string","description":"The address of the business or organization using the Tollfree number."},"BusinessStreetAddress2":{"type":"string","description":"The address of the business or organization using the Tollfree number."},"BusinessCity":{"type":"string","description":"The city of the business or organization using the Tollfree number."},"BusinessStateProvinceRegion":{"type":"string","description":"The state/province/region of the business or organization using the Tollfree number."},"BusinessPostalCode":{"type":"string","description":"The postal code of the business or organization using the Tollfree number."},"BusinessCountry":{"type":"string","description":"The country of the business or organization using the Tollfree number."},"AdditionalInformation":{"type":"string","description":"Additional information to be provided for verification."},"BusinessContactFirstName":{"type":"string","description":"The first name of the contact for the business or organization using the Tollfree number."},"BusinessContactLastName":{"type":"string","description":"The last name of the contact for the business or organization using the Tollfree number."},"BusinessContactEmail":{"type":"string","description":"The email address of the contact for the business or organization using the Tollfree number."},"BusinessContactPhone":{"type":"string","format":"phone-number","description":"The E.164 formatted phone number of the contact for the business or organization using the Tollfree number."},"EditReason":{"type":"string","description":"Describe why the verification is being edited. If the verification was rejected because of a technical issue, such as the website being down, and the issue has been resolved this parameter should be set to something similar to 'Website fixed'."},"BusinessRegistrationNumber":{"type":"string","description":"A legally recognized business registration number"},"BusinessRegistrationAuthority":{"type":"string","nullable":true,"enum":["EIN","CBN","CRN","PROVINCIAL_NUMBER","VAT","ACN","ABN","BRN","SIREN","SIRET","NZBN","USt-IdNr","CIF","NIF","CNPJ","UID","NEQ","OTHER"],"description":"The organizational authority for business registrations. Required for all business types except SOLE_PROPRIETOR.","refName":"tollfree_verification_enum_business_registration_authority","modelName":"tollfree_verification_enum_business_registration_authority"},"BusinessRegistrationCountry":{"type":"string","description":"Country business is registered in"},"BusinessType":{"type":"string","enum":["PRIVATE_PROFIT","PUBLIC_PROFIT","SOLE_PROPRIETOR","NON_PROFIT","GOVERNMENT"],"nullable":true,"description":"The type of business, valid values are PRIVATE_PROFIT, PUBLIC_PROFIT, NON_PROFIT, SOLE_PROPRIETOR, GOVERNMENT. Required field.","refName":"tollfree_verification_enum_business_type","modelName":"tollfree_verification_enum_business_type"},"BusinessRegistrationPhoneNumber":{"type":"string","description":"The E.164 formatted number associated with the business."},"DoingBusinessAs":{"type":"string","description":"Trade name, sub entity, or downstream business name of business being submitted for verification"},"OptInConfirmationMessage":{"type":"string","description":"The confirmation message sent to users when they opt in to receive messages."},"HelpMessageSample":{"type":"string","description":"A sample help message provided to users."},"PrivacyPolicyUrl":{"type":"string","description":"The URL to the privacy policy for the business or organization."},"TermsAndConditionsUrl":{"type":"string","description":"The URL to the terms and conditions for the business or organization."},"AgeGatedContent":{"type":"boolean","description":"Indicates if the content is age gated."},"OptInKeywords":{"type":"array","description":"List of keywords that users can text in to opt in to receive messages.","items":{"type":"string"}},"VettingProvider":{"type":"string","nullable":true,"enum":["CAMPAIGN_VERIFY"],"description":"The third-party political vetting provider.","refName":"tollfree_verification_enum_vetting_provider","modelName":"tollfree_verification_enum_vetting_provider"},"VettingId":{"type":"string","description":"The unique ID of the vetting"}}},"examples":{"update":{"value":{"lang":"json","value":"{\n \"BusinessName\": \"Owl, Inc.\",\n \"BusinessStreetAddress\": \"123 Main Street\",\n \"BusinessStreetAddress2\": \"Suite 101\",\n \"BusinessCity\": \"Anytown\",\n \"BusinessStateProvinceRegion\": \"AA\",\n \"BusinessPostalCode\": \"11111\",\n \"BusinessCountry\": \"US\",\n \"BusinessWebsite\": \"http://www.company.com\",\n \"BusinessContactFirstName\": \"firstname\",\n \"BusinessContactLastName\": \"lastname\",\n \"BusinessContactEmail\": \"email@company.com\",\n \"BusinessContactPhone\": \"+11231231234\",\n \"NotificationEmail\": \"support@company.com\",\n \"UseCaseCategories\": [\n \"TWO_FACTOR_AUTHENTICATION\",\n \"MARKETING\"\n ],\n \"UseCaseSummary\": \"This number is used to send out promotional offers and coupons to the customers of John's Coffee Shop\",\n \"ProductionMessageSample\": \"lorem ipsum\",\n \"OptInImageUrls\": [\n \"https://testbusiness.com/images/image1.jpg\",\n \"https://testbusiness.com/images/image2.jpg\"\n ],\n \"OptInType\": \"VERBAL\",\n \"MessageVolume\": \"1,000\",\n \"AdditionalInformation\": \"see our privacy policy here www.johnscoffeeshop.com/privacypolicy\",\n \"EditReason\": \"Website fixed\",\n \"BusinessRegistrationNumber\": \"123456789\",\n \"BusinessRegistrationAuthority\": \"EIN\",\n \"BusinessRegistrationCountry\": \"US\",\n \"BusinessType\": \"PRIVATE_PROFIT\",\n \"BusinessRegistrationPhoneNumber\": \"+13023334444\",\n \"DoingBusinessAs\": \"Toms Widgets\",\n \"AgeGatedContent\": false,\n \"HelpMessageSample\": \"For help, reply HELP or visit our website.\",\n \"OptInConfirmationMessage\": \"Thank you for opting in!\",\n \"OptInKeywords\": [\n \"START\"\n ],\n \"PrivacyPolicyUrl\": \"https://www.example.com/privacy\",\n \"TermsAndConditionsUrl\": \"https://www.example.com/terms\"\n}","meta":"","code":"{\n \"BusinessName\": \"Owl, Inc.\",\n \"BusinessStreetAddress\": \"123 Main Street\",\n \"BusinessStreetAddress2\": \"Suite 101\",\n \"BusinessCity\": \"Anytown\",\n \"BusinessStateProvinceRegion\": \"AA\",\n \"BusinessPostalCode\": \"11111\",\n \"BusinessCountry\": \"US\",\n \"BusinessWebsite\": \"http://www.company.com\",\n \"BusinessContactFirstName\": \"firstname\",\n \"BusinessContactLastName\": \"lastname\",\n \"BusinessContactEmail\": \"email@company.com\",\n \"BusinessContactPhone\": \"+11231231234\",\n \"NotificationEmail\": \"support@company.com\",\n \"UseCaseCategories\": [\n \"TWO_FACTOR_AUTHENTICATION\",\n \"MARKETING\"\n ],\n \"UseCaseSummary\": \"This number is used to send out promotional offers and coupons to the customers of John's Coffee Shop\",\n \"ProductionMessageSample\": \"lorem ipsum\",\n \"OptInImageUrls\": [\n \"https://testbusiness.com/images/image1.jpg\",\n \"https://testbusiness.com/images/image2.jpg\"\n ],\n \"OptInType\": \"VERBAL\",\n \"MessageVolume\": \"1,000\",\n \"AdditionalInformation\": \"see our privacy policy here www.johnscoffeeshop.com/privacypolicy\",\n \"EditReason\": \"Website fixed\",\n \"BusinessRegistrationNumber\": \"123456789\",\n \"BusinessRegistrationAuthority\": \"EIN\",\n \"BusinessRegistrationCountry\": \"US\",\n \"BusinessType\": \"PRIVATE_PROFIT\",\n \"BusinessRegistrationPhoneNumber\": \"+13023334444\",\n \"DoingBusinessAs\": \"Toms Widgets\",\n \"AgeGatedContent\": false,\n \"HelpMessageSample\": \"For help, reply HELP or visit our website.\",\n \"OptInConfirmationMessage\": \"Thank you for opting in!\",\n \"OptInKeywords\": [\n \"START\"\n ],\n \"PrivacyPolicyUrl\": \"https://www.example.com/privacy\",\n \"TermsAndConditionsUrl\": \"https://www.example.com/terms\"\n}","tokens":[["{","#C9D1D9"],"\n ",["\"BusinessName\"","#7EE787"],[":","#C9D1D9"]," ",["\"Owl, Inc.\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessStreetAddress\"","#7EE787"],[":","#C9D1D9"]," ",["\"123 Main Street\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessStreetAddress2\"","#7EE787"],[":","#C9D1D9"]," ",["\"Suite 101\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessCity\"","#7EE787"],[":","#C9D1D9"]," ",["\"Anytown\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessStateProvinceRegion\"","#7EE787"],[":","#C9D1D9"]," ",["\"AA\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessPostalCode\"","#7EE787"],[":","#C9D1D9"]," ",["\"11111\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessCountry\"","#7EE787"],[":","#C9D1D9"]," ",["\"US\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessWebsite\"","#7EE787"],[":","#C9D1D9"]," ",["\"http://www.company.com\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessContactFirstName\"","#7EE787"],[":","#C9D1D9"]," ",["\"firstname\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessContactLastName\"","#7EE787"],[":","#C9D1D9"]," ",["\"lastname\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessContactEmail\"","#7EE787"],[":","#C9D1D9"]," ",["\"email@company.com\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessContactPhone\"","#7EE787"],[":","#C9D1D9"]," ",["\"+11231231234\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"NotificationEmail\"","#7EE787"],[":","#C9D1D9"]," ",["\"support@company.com\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"UseCaseCategories\"","#7EE787"],[": [","#C9D1D9"],"\n ",["\"TWO_FACTOR_AUTHENTICATION\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"MARKETING\"","#A5D6FF"],"\n ",["],","#C9D1D9"],"\n ",["\"UseCaseSummary\"","#7EE787"],[":","#C9D1D9"]," ",["\"This number is used to send out promotional offers and coupons to the customers of John's Coffee Shop\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"ProductionMessageSample\"","#7EE787"],[":","#C9D1D9"]," ",["\"lorem ipsum\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"OptInImageUrls\"","#7EE787"],[": [","#C9D1D9"],"\n ",["\"https://testbusiness.com/images/image1.jpg\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"https://testbusiness.com/images/image2.jpg\"","#A5D6FF"],"\n ",["],","#C9D1D9"],"\n ",["\"OptInType\"","#7EE787"],[":","#C9D1D9"]," ",["\"VERBAL\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"MessageVolume\"","#7EE787"],[":","#C9D1D9"]," ",["\"1,000\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"AdditionalInformation\"","#7EE787"],[":","#C9D1D9"]," ",["\"see our privacy policy here www.johnscoffeeshop.com/privacypolicy\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"EditReason\"","#7EE787"],[":","#C9D1D9"]," ",["\"Website fixed\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessRegistrationNumber\"","#7EE787"],[":","#C9D1D9"]," ",["\"123456789\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessRegistrationAuthority\"","#7EE787"],[":","#C9D1D9"]," ",["\"EIN\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessRegistrationCountry\"","#7EE787"],[":","#C9D1D9"]," ",["\"US\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessType\"","#7EE787"],[":","#C9D1D9"]," ",["\"PRIVATE_PROFIT\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BusinessRegistrationPhoneNumber\"","#7EE787"],[":","#C9D1D9"]," ",["\"+13023334444\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"DoingBusinessAs\"","#7EE787"],[":","#C9D1D9"]," ",["\"Toms Widgets\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"AgeGatedContent\"","#7EE787"],[":","#C9D1D9"]," ",["false","#79C0FF"],[",","#C9D1D9"],"\n ",["\"HelpMessageSample\"","#7EE787"],[":","#C9D1D9"]," ",["\"For help, reply HELP or visit our website.\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"OptInConfirmationMessage\"","#7EE787"],[":","#C9D1D9"]," ",["\"Thank you for opting in!\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"OptInKeywords\"","#7EE787"],[": [","#C9D1D9"],"\n ",["\"START\"","#A5D6FF"],"\n ",["],","#C9D1D9"],"\n ",["\"PrivacyPolicyUrl\"","#7EE787"],[":","#C9D1D9"]," ",["\"https://www.example.com/privacy\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"TermsAndConditionsUrl\"","#7EE787"],[":","#C9D1D9"]," ",["\"https://www.example.com/terms\"","#A5D6FF"],"\n",["}","#C9D1D9"]],"annotations":[],"themeName":"github-dark","style":{"color":"#c9d1d9","background":"#0d1117"}}}},"encodingType":"application/x-www-form-urlencoded","conditionalParameterMap":{}} ``` Update a TFV request ```js // Download the helper library from https://www.twilio.com/docs/node/install const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio"; // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure const accountSid = process.env.TWILIO_ACCOUNT_SID; const authToken = process.env.TWILIO_AUTH_TOKEN; const client = twilio(accountSid, authToken); async function updateTollfreeVerification() { const tollfreeVerification = await client.messaging.v1 .tollfreeVerifications("HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") .update({ additionalInformation: "See our privacy policy at www.example.com/privacypolicy", editReason: "Updated the ProductionMessageSample", messageVolume: "1,000", optInImageUrls: [ "https://example.com/images/image1.jpg", "https://example.com/images/image2.jpg", ], optInType: "VERBAL", productionMessageSample: "Get 10% off when you save this coupon: https://bit.ly/owlcoupon", useCaseCategories: ["TWO_FACTOR_AUTHENTICATION", "MARKETING"], useCaseSummary: "This number is used to send out promotional offers and coupons to the customers of Owl, Inc.", }); console.log(tollfreeVerification.sid); } updateTollfreeVerification(); ``` ```python # Download the helper library from https://www.twilio.com/docs/python/install import os from twilio.rest import Client # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = os.environ["TWILIO_ACCOUNT_SID"] auth_token = os.environ["TWILIO_AUTH_TOKEN"] client = Client(account_sid, auth_token) tollfree_verification = client.messaging.v1.tollfree_verifications( "HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" ).update( edit_reason="Updated the ProductionMessageSample", use_case_categories=["TWO_FACTOR_AUTHENTICATION", "MARKETING"], use_case_summary="This number is used to send out promotional offers and coupons to the customers of Owl, Inc.", production_message_sample="Get 10% off when you save this coupon: https://bit.ly/owlcoupon", opt_in_image_urls=[ "https://example.com/images/image1.jpg", "https://example.com/images/image2.jpg", ], opt_in_type="VERBAL", message_volume="1,000", additional_information="See our privacy policy at www.example.com/privacypolicy", ) print(tollfree_verification.sid) ``` ```csharp // Install the C# / .NET helper library from twilio.com/docs/csharp/install using System; using Twilio; using Twilio.Rest.Messaging.V1; using System.Threading.Tasks; using System.Collections.Generic; class Program { public static async Task Main(string[] args) { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID"); string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN"); TwilioClient.Init(accountSid, authToken); var tollfreeVerification = await TollfreeVerificationResource.UpdateAsync( editReason: "Updated the ProductionMessageSample", useCaseCategories: new List { "TWO_FACTOR_AUTHENTICATION", "MARKETING" }, useCaseSummary: "This number is used to send out promotional offers and coupons to the customers of Owl, Inc.", productionMessageSample: "Get 10% off when you save this coupon: https://bit.ly/owlcoupon", optInImageUrls: new List< string> { "https://example.com/images/image1.jpg", "https://example.com/images/image2.jpg" }, optInType: TollfreeVerificationResource.OptInTypeEnum.Verbal, messageVolume: "1,000", additionalInformation: "See our privacy policy at www.example.com/privacypolicy", pathSid: "HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"); Console.WriteLine(tollfreeVerification.Sid); } } ``` ```java // Install the Java helper library from twilio.com/docs/java/install import java.util.Arrays; import com.twilio.Twilio; import com.twilio.rest.messaging.v1.TollfreeVerification; public class Example { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID"); public static final String AUTH_TOKEN = System.getenv("TWILIO_AUTH_TOKEN"); public static void main(String[] args) { Twilio.init(ACCOUNT_SID, AUTH_TOKEN); TollfreeVerification tollfreeVerification = TollfreeVerification.updater("HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") .setEditReason("Updated the ProductionMessageSample") .setUseCaseCategories(Arrays.asList("TWO_FACTOR_AUTHENTICATION", "MARKETING")) .setUseCaseSummary( "This number is used to send out promotional offers and coupons to the customers of Owl, Inc.") .setProductionMessageSample("Get 10% off when you save this coupon: https://bit.ly/owlcoupon") .setOptInImageUrls( Arrays.asList("https://example.com/images/image1.jpg", "https://example.com/images/image2.jpg")) .setOptInType(TollfreeVerification.OptInType.VERBAL) .setMessageVolume("1,000") .setAdditionalInformation("See our privacy policy at www.example.com/privacypolicy") .update(); System.out.println(tollfreeVerification.getSid()); } } ``` ```go // Download the helper library from https://www.twilio.com/docs/go/install package main import ( "fmt" "github.com/twilio/twilio-go" messaging "github.com/twilio/twilio-go/rest/messaging/v1" "os" ) func main() { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure // Make sure TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN exists in your environment client := twilio.NewRestClient() params := &messaging.UpdateTollfreeVerificationParams{} params.SetEditReason("Updated the ProductionMessageSample") params.SetUseCaseCategories([]string{ "TWO_FACTOR_AUTHENTICATION", "MARKETING", }) params.SetUseCaseSummary("This number is used to send out promotional offers and coupons to the customers of Owl, Inc.") params.SetProductionMessageSample("Get 10% off when you save this coupon: https://bit.ly/owlcoupon") params.SetOptInImageUrls([]string{ "https://example.com/images/image1.jpg", "https://example.com/images/image2.jpg", }) params.SetOptInType("VERBAL") params.SetMessageVolume("1,000") params.SetAdditionalInformation("See our privacy policy at www.example.com/privacypolicy") resp, err := client.MessagingV1.UpdateTollfreeVerification("HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", params) if err != nil { fmt.Println(err.Error()) os.Exit(1) } else { if resp.Sid != nil { fmt.Println(*resp.Sid) } else { fmt.Println(resp.Sid) } } } ``` ```php messaging->v1 ->tollfreeVerifications("HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") ->update([ "editReason" => "Updated the ProductionMessageSample", "useCaseCategories" => ["TWO_FACTOR_AUTHENTICATION", "MARKETING"], "useCaseSummary" => "This number is used to send out promotional offers and coupons to the customers of Owl, Inc.", "productionMessageSample" => "Get 10% off when you save this coupon: https://bit.ly/owlcoupon", "optInImageUrls" => [ "https://example.com/images/image1.jpg", "https://example.com/images/image2.jpg", ], "optInType" => "VERBAL", "messageVolume" => "1,000", "additionalInformation" => "See our privacy policy at www.example.com/privacypolicy", ]); print $tollfree_verification->sid; ``` ```ruby # Download the helper library from https://www.twilio.com/docs/ruby/install require 'twilio-ruby' # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = ENV['TWILIO_ACCOUNT_SID'] auth_token = ENV['TWILIO_AUTH_TOKEN'] @client = Twilio::REST::Client.new(account_sid, auth_token) tollfree_verification = @client .messaging .v1 .tollfree_verifications('HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa') .update( edit_reason: 'Updated the ProductionMessageSample', use_case_categories: [ 'TWO_FACTOR_AUTHENTICATION', 'MARKETING' ], use_case_summary: 'This number is used to send out promotional offers and coupons to the customers of Owl, Inc.', production_message_sample: 'Get 10% off when you save this coupon: https://bit.ly/owlcoupon', opt_in_image_urls: [ 'https://example.com/images/image1.jpg', 'https://example.com/images/image2.jpg' ], opt_in_type: 'VERBAL', message_volume: '1,000', additional_information: 'See our privacy policy at www.example.com/privacypolicy' ) puts tollfree_verification.sid ``` ```bash # Install the twilio-cli from https://twil.io/cli twilio api:messaging:v1:tollfree:verifications:update \ --sid HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa \ --edit-reason "Updated the ProductionMessageSample" \ --use-case-categories TWO_FACTOR_AUTHENTICATION MARKETING \ --use-case-summary "This number is used to send out promotional offers and coupons to the customers of Owl, Inc." \ --production-message-sample "Get 10% off when you save this coupon: https://bit.ly/owlcoupon" \ --opt-in-image-urls https://example.com/images/image1.jpg https://example.com/images/image2.jpg \ --opt-in-type VERBAL \ --message-volume 1,000 \ --additional-information "See our privacy policy at www.example.com/privacypolicy" ``` ```bash curl -X POST "https://messaging.twilio.com/v1/Tollfree/Verifications/HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \ --data-urlencode "EditReason=Updated the ProductionMessageSample" \ --data-urlencode "UseCaseCategories=TWO_FACTOR_AUTHENTICATION" \ --data-urlencode "UseCaseCategories=MARKETING" \ --data-urlencode "UseCaseSummary=This number is used to send out promotional offers and coupons to the customers of Owl, Inc." \ --data-urlencode "ProductionMessageSample=Get 10% off when you save this coupon: https://bit.ly/owlcoupon" \ --data-urlencode "OptInImageUrls=https://example.com/images/image1.jpg" \ --data-urlencode "OptInImageUrls=https://example.com/images/image2.jpg" \ --data-urlencode "OptInType=VERBAL" \ --data-urlencode "MessageVolume=1,000" \ --data-urlencode "AdditionalInformation=See our privacy policy at www.example.com/privacypolicy" \ -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN ``` ```json { "sid": "HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "regulated_item_sid": null, "customer_profile_sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "trust_product_sid": null, "status": "PENDING_REVIEW", "date_created": "2021-01-27T14:18:35Z", "date_updated": "2021-01-27T14:18:36Z", "business_name": "Owl, Inc.", "business_street_address": "123 Main Street", "business_street_address2": "Suite 101", "business_city": "Anytown", "business_state_province_region": "AA", "business_postal_code": "11111", "business_country": "US", "business_website": "http://www.company.com", "business_contact_first_name": "firstname", "business_contact_last_name": "lastname", "business_contact_email": "email@company.com", "business_contact_phone": "+11231231234", "notification_email": "support@company.com", "use_case_categories": [ "TWO_FACTOR_AUTHENTICATION", "MARKETING" ], "use_case_summary": "This number is used to send out promotional offers and coupons to the customers of Owl, Inc.", "production_message_sample": "Get 10% off when you save this coupon: https://bit.ly/owlcoupon", "opt_in_image_urls": [ "https://example.com/images/image1.jpg", "https://example.com/images/image2.jpg" ], "opt_in_type": "VERBAL", "message_volume": "1,000", "additional_information": "See our privacy policy at www.example.com/privacypolicy", "tollfree_phone_number_sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "rejection_reason": null, "error_code": null, "edit_expiration": null, "edit_allowed": null, "rejection_reasons": null, "resource_links": {}, "url": "https://messaging.twilio.com/v1/Tollfree/Verifications/HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "external_reference_id": null, "business_registration_number": "123456789", "business_registration_authority": "EIN", "business_registration_country": "US", "business_type": "PRIVATE_PROFIT", "business_registration_phone_number": "+13023334444", "doing_business_as": "Toms Widgets", "age_gated_content": false, "help_message_sample": "For help, reply HELP or visit our website.", "opt_in_confirmation_message": "Thank you for opting in!", "opt_in_keywords": [ "START" ], "privacy_policy_url": "https://www.example.com/privacy", "terms_and_conditions_url": "https://www.example.com/terms", "tollfree_phone_number": "+18003334444", "vetting_id": null, "vetting_id_expiration": null, "vetting_provider": null } ``` ## Delete a TFV request `DELETE https://messaging.twilio.com/v1/Tollfree/Verifications/{Sid}` ### Path parameters ```json [{"name":"Sid","in":"path","description":"The unique string to identify Tollfree Verification.","schema":{"type":"string","minLength":34,"maxLength":34,"pattern":"^HH[0-9a-fA-F]{32}$"},"required":true}] ``` Delete a TFV request ```js // Download the helper library from https://www.twilio.com/docs/node/install const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio"; // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure const accountSid = process.env.TWILIO_ACCOUNT_SID; const authToken = process.env.TWILIO_AUTH_TOKEN; const client = twilio(accountSid, authToken); async function deleteTollfreeVerification() { await client.messaging.v1 .tollfreeVerifications("HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") .remove(); } deleteTollfreeVerification(); ``` ```python # Download the helper library from https://www.twilio.com/docs/python/install import os from twilio.rest import Client # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = os.environ["TWILIO_ACCOUNT_SID"] auth_token = os.environ["TWILIO_AUTH_TOKEN"] client = Client(account_sid, auth_token) client.messaging.v1.tollfree_verifications( "HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" ).delete() ``` ```csharp // Install the C# / .NET helper library from twilio.com/docs/csharp/install using System; using Twilio; using Twilio.Rest.Messaging.V1; using System.Threading.Tasks; class Program { public static async Task Main(string[] args) { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID"); string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN"); TwilioClient.Init(accountSid, authToken); await TollfreeVerificationResource.DeleteAsync( pathSid: "HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"); } } ``` ```java // Install the Java helper library from twilio.com/docs/java/install import com.twilio.Twilio; import com.twilio.rest.messaging.v1.TollfreeVerification; public class Example { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID"); public static final String AUTH_TOKEN = System.getenv("TWILIO_AUTH_TOKEN"); public static void main(String[] args) { Twilio.init(ACCOUNT_SID, AUTH_TOKEN); TollfreeVerification.deleter("HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa").delete(); } } ``` ```go // Download the helper library from https://www.twilio.com/docs/go/install package main import ( "fmt" "github.com/twilio/twilio-go" "os" ) func main() { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure // Make sure TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN exists in your environment client := twilio.NewRestClient() err := client.MessagingV1.DeleteTollfreeVerification("HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") if err != nil { fmt.Println(err.Error()) os.Exit(1) } } ``` ```php messaging->v1 ->tollfreeVerifications("HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") ->delete(); ``` ```ruby # Download the helper library from https://www.twilio.com/docs/ruby/install require 'twilio-ruby' # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = ENV['TWILIO_ACCOUNT_SID'] auth_token = ENV['TWILIO_AUTH_TOKEN'] @client = Twilio::REST::Client.new(account_sid, auth_token) @client .messaging .v1 .tollfree_verifications('HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa') .delete ``` ```bash # Install the twilio-cli from https://twil.io/cli twilio api:messaging:v1:tollfree:verifications:remove \ --sid HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa ``` ```bash curl -X DELETE "https://messaging.twilio.com/v1/Tollfree/Verifications/HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \ -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN ```