Update tollfree verification
A Messaging resource to create and retrieve Tollfree Verifications.
Path parameters
-
The unique string to identify Tollfree Verification.
Minimum length is
34
, maximum length is34
. Format should match the following pattern:^HH[0-9a-fA-F]{32}$
.
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 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.
-
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'.
curl \
--request POST 'https://messaging.twilio.com/v1/Tollfree/Verifications/{Sid}' \
--user "username:password" \
--header "Content-Type: application/x-www-form-urlencoded" \
--data 'OptInType=VERBAL&EditReason=Website+fixed&BusinessCity=Anytown&BusinessName=Owl%2C+Inc.&MessageVolume=1%2C000&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&BusinessContactEmail=email%40company.com&BusinessContactPhone=%2B11231231234&AdditionalInformation=see+our+privacy+policy+here+www.johnscoffeeshop.com%2Fprivacypolicy&BusinessStreetAddress=123+Main+Street&BusinessStreetAddress2=Suite+101&BusinessContactLastName=lastname&ProductionMessageSample=lorem+ipsum&BusinessContactFirstName=firstname&BusinessStateProvinceRegion=AA'
{"OptInType"=>"VERBAL", "EditReason"=>"Website fixed", "BusinessCity"=>"Anytown", "BusinessName"=>"Owl, Inc.", "MessageVolume"=>"1,000", "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", "BusinessContactEmail"=>"email@company.com", "BusinessContactPhone"=>"+11231231234", "AdditionalInformation"=>"see our privacy policy here www.johnscoffeeshop.com/privacypolicy", "BusinessStreetAddress"=>"123 Main Street", "BusinessStreetAddress2"=>"Suite 101", "BusinessContactLastName"=>"lastname", "ProductionMessageSample"=>"lorem ipsum", "BusinessContactFirstName"=>"firstname", "BusinessStateProvinceRegion"=>"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": "1,000",
"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": null,
"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"
}