Create tollfree verification
A Messaging resource to create and retrieve Tollfree Verifications.
Body
-
The name of the business or organization using the Tollfree number.
-
The website of the business or organization using the Tollfree number.
-
The email address to receive the notification about the verification result. .
-
The category of the use case for the Tollfree Number. List as many are applicable..
-
Use this to further explain how messaging is used by the business or organization.
-
An example of message content, i.e. a sample message.
-
Link to an image that shows the opt-in workflow. Multiple images allowed and must be a publicly hosted URL.
-
Describe how a user opts-in to text messages.
Values are
VERBAL,WEB_FORM,PAPER_FORM,VIA_TEXT,MOBILE_QR_CODE,IMPORT, orIMPORT_PLEASE_REPLACE. -
Estimate monthly volume of messages from the Tollfree Number.
-
The SID of the Phone Number associated with the Tollfree Verification.
Minimum length is
34, maximum length is34. Format should match the following pattern:^PN[0-9a-fA-F]{32}$. -
Customer's Profile Bundle BundleSid.
Minimum length is
34, maximum length is34. Format should match the following pattern:^BU[0-9a-fA-F]{32}$. -
The address of the business or organization using the Tollfree number.
-
The address of the business or organization using the Tollfree number.
-
The city of the business or organization using the Tollfree number.
-
The state/province/region of the business or organization using the Tollfree number.
-
The postal code of the business or organization using the Tollfree number.
-
The country of the business or organization using the Tollfree number.
-
Additional information to be provided for verification.
-
The first name of the contact for the business or organization using the Tollfree number.
-
The last name of the contact for the business or organization using the Tollfree number.
-
The email address of the contact for the business or organization using the Tollfree number.
-
The E.164 formatted phone number of the contact for the business or organization using the Tollfree number.
-
An optional external reference ID supplied by customer and echoed back on status retrieval.
curl \
--request POST 'https://messaging.twilio.com/v1/Tollfree/Verifications' \
--user "username:password" \
--header "Content-Type: application/x-www-form-urlencoded" \
--data 'OptInType=VERBAL&BusinessCity=Anytown&BusinessName=Owl%2C+Inc.&MessageVolume=10&OptInImageUrls=https%3A%2F%2Ftestbusiness.com%2Fimages%2Fimage1.jpg&OptInImageUrls=https%3A%2F%2Ftestbusiness.com%2Fimages%2Fimage2.jpg&UseCaseSummary=This+number+is+used+to+send+out+promotional+offers+and+coupons+to+the+customers+of+John%27s+Coffee+Shop&BusinessCountry=US&BusinessWebsite=http%3A%2F%2Fwww.company.com&NotificationEmail=support%40company.com&UseCaseCategories=TWO_FACTOR_AUTHENTICATION&UseCaseCategories=MARKETING&BusinessPostalCode=11111&ExternalReferenceId=abc123xyz567&BusinessContactEmail=email%40company.com&BusinessContactPhone=%2B11231231234&AdditionalInformation=see+our+privacy+policy+here+www.johnscoffeeshop.com%2Fprivacypolicy&BusinessStreetAddress=123+Main+Street&BusinessStreetAddress2=Suite+101&TollfreePhoneNumberSid=PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&BusinessContactLastName=lastname&ProductionMessageSample=lorem+ipsum&BusinessContactFirstName=firstname&BusinessStateProvinceRegion=AA'
{"OptInType" => "VERBAL", "BusinessCity" => "Anytown", "BusinessName" => "Owl, Inc.", "MessageVolume" => "10", "OptInImageUrls" => ["https://testbusiness.com/images/image1.jpg", "https://testbusiness.com/images/image2.jpg"], "UseCaseSummary" => "This number is used to send out promotional offers and coupons to the customers of John's Coffee Shop", "BusinessCountry" => "US", "BusinessWebsite" => "http://www.company.com", "NotificationEmail" => "support@company.com", "UseCaseCategories" => ["TWO_FACTOR_AUTHENTICATION", "MARKETING"], "BusinessPostalCode" => "11111", "ExternalReferenceId" => "abc123xyz567", "BusinessContactEmail" => "email@company.com", "BusinessContactPhone" => "+11231231234", "AdditionalInformation" => "see our privacy policy here www.johnscoffeeshop.com/privacypolicy", "BusinessStreetAddress" => "123 Main Street", "BusinessStreetAddress2" => "Suite 101", "TollfreePhoneNumberSid" => "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "BusinessContactLastName" => "lastname", "ProductionMessageSample" => "lorem ipsum", "BusinessContactFirstName" => "firstname", "BusinessStateProvinceRegion" => "AA"}
{"OptInType" => "VERBAL", "BusinessName" => "Owl, Inc.", "MessageVolume" => "10", "OptInImageUrls" => ["https://testbusiness.com/images/image1.jpg", "https://testbusiness.com/images/image2.jpg"], "UseCaseSummary" => "This number is used to send out promotional offers and coupons to the customers of John's Coffee Shop", "BusinessWebsite" => "http://www.company.com", "NotificationEmail" => "support@company.com", "UseCaseCategories" => ["TWO_FACTOR_AUTHENTICATION", "MARKETING"], "CustomerProfileSid" => "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "ExternalReferenceId" => "abc123xyz567", "AdditionalInformation" => "see our privacy policy here www.johnscoffeeshop.com/privacypolicy", "TollfreePhoneNumberSid" => "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "ProductionMessageSample" => "lorem ipsum"}
{
"sid": "HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"url": "https://messaging.twilio.com/v1/Tollfree/Verifications/HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "PENDING_REVIEW",
"error_code": null,
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"opt_in_type": "VERBAL",
"date_created": "2021-01-27T14:18:35Z",
"date_updated": "2021-01-27T14:18:36Z",
"edit_allowed": null,
"business_city": "Anytown",
"business_name": "Owl, Inc.",
"message_volume": "10",
"resource_links": {},
"edit_expiration": null,
"business_country": "US",
"business_website": "http://www.company.com",
"rejection_reason": null,
"use_case_summary": "This number is used to send out promotional offers and coupons to the customers of John's Coffee Shop",
"opt_in_image_urls": [
"https://testbusiness.com/images/image1.jpg",
"https://testbusiness.com/images/image2.jpg"
],
"rejection_reasons": null,
"trust_product_sid": null,
"notification_email": "support@company.com",
"regulated_item_sid": null,
"use_case_categories": [
"TWO_FACTOR_AUTHENTICATION",
"MARKETING"
],
"business_postal_code": "11111",
"customer_profile_sid": null,
"external_reference_id": "abc123xyz567",
"additional_information": "see our privacy policy here www.johnscoffeeshop.com/privacypolicy",
"business_contact_email": "email@company.com",
"business_contact_phone": "+11231231234",
"business_street_address": "123 Main Street",
"business_street_address2": "Suite 101",
"production_message_sample": "lorem ipsum",
"tollfree_phone_number_sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"business_contact_last_name": "lastname",
"business_contact_first_name": "firstname",
"business_state_province_region": "AA"
}
{
"sid": "HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"url": "https://messaging.twilio.com/v1/Tollfree/Verifications/HHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "PENDING_REVIEW",
"error_code": null,
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"opt_in_type": "VERBAL",
"date_created": "2021-01-27T14:18:35Z",
"date_updated": "2021-01-27T14:18:36Z",
"edit_allowed": null,
"business_city": "Anytown",
"business_name": "Owl, Inc.",
"message_volume": "10",
"resource_links": {},
"edit_expiration": null,
"business_country": "US",
"business_website": "http://www.company.com",
"rejection_reason": null,
"use_case_summary": "This number is used to send out promotional offers and coupons to the customers of John's Coffee Shop",
"opt_in_image_urls": [
"https://testbusiness.com/images/image1.jpg",
"https://testbusiness.com/images/image2.jpg"
],
"rejection_reasons": null,
"trust_product_sid": null,
"notification_email": "support@company.com",
"regulated_item_sid": null,
"use_case_categories": [
"TWO_FACTOR_AUTHENTICATION",
"MARKETING"
],
"business_postal_code": "11111",
"customer_profile_sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"external_reference_id": "abc123xyz567",
"additional_information": "see our privacy policy here www.johnscoffeeshop.com/privacypolicy",
"business_contact_email": "email@company.com",
"business_contact_phone": "+11231231234",
"business_street_address": "123 Main Street",
"business_street_address2": "Suite 101",
"production_message_sample": "lorem ipsum",
"tollfree_phone_number_sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"business_contact_last_name": "lastname",
"business_contact_first_name": "firstname",
"business_state_province_region": "AA"
}