# Update tollfree verification

**POST /v1/Tollfree/Verifications/{Sid}**


A Messaging resource to create and retrieve Tollfree Verifications.

## Servers
- https://messaging.twilio.com: https://messaging.twilio.com ()


## Authentication methods
- Account sid auth token


## Parameters

### Path parameters
- **Sid** (string)
  The unique string to identify Tollfree Verification.


### Body: application/x-www-form-urlencoded (object)

- **BusinessName** (string)
  The name of the business or organization using the Tollfree number.
- **BusinessWebsite** (string)
  The website of the business or organization using the Tollfree number.
- **NotificationEmail** (string)
  The email address to receive the notification about the verification result. .
- **UseCaseCategories** (array[string])
  The category of the use case for the Tollfree Number. List as many are applicable..
- **UseCaseSummary** (string)
  Use this to further explain how messaging is used by the business or organization.
- **ProductionMessageSample** (string)
  An example of message content, i.e. a sample message.
- **OptInImageUrls** (array[string])
  Link to an image that shows the opt-in workflow. Multiple images allowed and must be a publicly hosted URL.
- **OptInType** (string)
  Describe how a user opts-in to text messages.
- **MessageVolume** (string)
  Estimate monthly volume of messages from the Tollfree Number.
- **BusinessStreetAddress** (string)
  The address of the business or organization using the Tollfree number.
- **BusinessStreetAddress2** (string)
  The address of the business or organization using the Tollfree number.
- **BusinessCity** (string)
  The city of the business or organization using the Tollfree number.
- **BusinessStateProvinceRegion** (string)
  The state/province/region of the business or organization using the Tollfree number.
- **BusinessPostalCode** (string)
  The postal code of the business or organization using the Tollfree number.
- **BusinessCountry** (string)
  The country of the business or organization using the Tollfree number.
- **AdditionalInformation** (string)
  Additional information to be provided for verification.
- **BusinessContactFirstName** (string)
  The first name of the contact for the business or organization using the Tollfree number.
- **BusinessContactLastName** (string)
  The last name of the contact for the business or organization using the Tollfree number.
- **BusinessContactEmail** (string)
  The email address of the contact for the business or organization using the Tollfree number.
- **BusinessContactPhone** (string(phone-number))
  The E.164 formatted phone number of the contact for the business or organization using the Tollfree number.
- **EditReason** (string)
  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'.


## Responses
### 202
Accepted
#### Headers
- **Access-Control-Allow-Origin** (string)
  Specify the origin(s) allowed to access the resource
- **Access-Control-Allow-Methods** (string)
  Specify the HTTP methods allowed when accessing the resource
- **Access-Control-Allow-Headers** (string)
  Specify the headers allowed when accessing the resource
- **Access-Control-Allow-Credentials** (boolean)
  Indicates whether the browser should include credentials
- **Access-Control-Expose-Headers** (string)
  Headers exposed to the client

#### Body: application/json (object)
- **sid** (string | null)
  The unique string to identify Tollfree Verification.
- **account_sid** (string | null)
  The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Tollfree Verification resource.
- **customer_profile_sid** (string | null)
  Customer's Profile Bundle BundleSid.
- **trust_product_sid** (string | null)
  Tollfree TrustProduct Bundle BundleSid.
- **date_created** (string(date-time) | null)
  The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
- **date_updated** (string(date-time) | null)
  The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
- **regulated_item_sid** (string | null)
  The SID of the Regulated Item.
- **business_name** (string | null)
  The name of the business or organization using the Tollfree number.
- **business_street_address** (string | null)
  The address of the business or organization using the Tollfree number.
- **business_street_address2** (string | null)
  The address of the business or organization using the Tollfree number.
- **business_city** (string | null)
  The city of the business or organization using the Tollfree number.
- **business_state_province_region** (string | null)
  The state/province/region of the business or organization using the Tollfree number.
- **business_postal_code** (string | null)
  The postal code of the business or organization using the Tollfree number.
- **business_country** (string | null)
  The country of the business or organization using the Tollfree number.
- **business_website** (string | null)
  The website of the business or organization using the Tollfree number.
- **business_contact_first_name** (string | null)
  The first name of the contact for the business or organization using the Tollfree number.
- **business_contact_last_name** (string | null)
  The last name of the contact for the business or organization using the Tollfree number.
- **business_contact_email** (string | null)
  The email address of the contact for the business or organization using the Tollfree number.
- **business_contact_phone** (string(phone-number) | null)
  The E.164 formatted phone number of the contact for the business or organization using the Tollfree number.
- **notification_email** (string | null)
  The email address to receive the notification about the verification result. .
- **use_case_categories** (array[string] | null)
  The category of the use case for the Tollfree Number. List as many are applicable..
- **use_case_summary** (string | null)
  Use this to further explain how messaging is used by the business or organization.
- **production_message_sample** (string | null)
  An example of message content, i.e. a sample message.
- **opt_in_image_urls** (array[string] | null)
  Link to an image that shows the opt-in workflow. Multiple images allowed and must be a publicly hosted URL.
- **opt_in_type** (string)
  Describe how a user opts-in to text messages.
- **message_volume** (string | null)
  Estimate monthly volume of messages from the Tollfree Number.
- **additional_information** (string | null)
  Additional information to be provided for verification.
- **tollfree_phone_number_sid** (string | null)
  The SID of the Phone Number associated with the Tollfree Verification.
- **status** (string)
  The compliance status of the Tollfree Verification record.
- **url** (string(uri) | null)
  The absolute URL of the Tollfree Verification resource.
- **rejection_reason** (string | null)
  The rejection reason given when a Tollfree Verification has been rejected.
- **error_code** (integer | null)
  The error code given when a Tollfree Verification has been rejected.
- **edit_expiration** (string(date-time) | null)
  The date and time when the ability to edit a rejected verification expires.
- **edit_allowed** (boolean | null)
  If a rejected verification is allowed to be edited/resubmitted. Some rejection reasons allow editing and some do not.
- **rejection_reasons** (array | null)
  A list of rejection reasons and codes describing why a Tollfree Verification has been rejected.
- **resource_links** (object | null)
  The URLs of the documents associated with the Tollfree Verification resource.
- **external_reference_id** (string | null)
  An optional external reference ID supplied by customer and echoed back on status retrieval.


[Powered by Bump.sh](https://bump.sh)