---
title: "Update Verification Request"
method: PATCH
path: "/messaging_tollfree/verification/requests/{id}"
tags: ["Verification Requests"]
---

# Update Verification Request

`PATCH /messaging_tollfree/verification/requests/{id}`

Update an existing tollfree verification request. This is particularly useful when there are pending customer actions to be taken.

## Path parameters

- `id` string, uuid, required

## Request body

- TollFreeVerificationTFVerificationRequest — The body of a tollfree verification request
  - `additionalInformation` string, required — Any additional information
  - `ageGatedContent` boolean — Indicates if messaging content requires age gating (e.g., 18+). Defaults to false if not provided.
  - `businessAddr1` string, required — Line 1 of the business address
  - `businessAddr2` string — Line 2 of the business address
  - `businessCity` string, required — The city of the business address; the first letter should be capitalized
  - `businessContactEmail` string, required — The email address of the business contact
  - `businessContactFirstName` string, required — First name of the business contact; there are no specific requirements on formatting
  - `businessContactLastName` string, required — Last name of the business contact; there are no specific requirements on formatting
  - `businessContactPhone` string, required — The phone number of the business contact in E.164 format
  - `businessName` string, required — Name of the business; there are no specific formatting requirements
  - `businessRegistrationCountry` string, nullable — ISO 3166-1 alpha-2 country code of the issuing business authority. Must be exactly 2 letters. Automatically converted to uppercase. Required from January 2026.
  - `businessRegistrationNumber` string, nullable — Official business registration number (e.g., Employer Identification Number (EIN) in the U.S.). Required from January 2026.
  - `businessRegistrationType` string, nullable — Type of business registration being provided. Required from January 2026.
  - `businessState` string, required — The full name of the state (not the 2 letter code) of the business address; the first letter should be capitalized
  - `businessZip` string, required — The ZIP code of the business address
  - `campaignVerifyAuthorizationToken` string, nullable — Campaign Verify Authorization Token required for Political use case submissions starting February 17, 2026. This token is validated by Zipwhip and must be provided for all Political use case verifications after the deadline.
  - `corporateWebsite` string, required — A URL, including the scheme, pointing to the corporate website
  - `doingBusinessAs` string, nullable — Doing Business As (DBA) name if different from legal name
  - `entityType` 'SOLE_PROPRIETOR' | 'PRIVATE_PROFIT' | 'PUBLIC_PROFIT' | 'NON_PROFIT' | 'GOVERNMENT' — Business entity classification
  - `helpMessageResponse` string, nullable — The message returned when users text 'HELP'
  - `isvReseller` string, nullable — ISV name
  - `messageVolume` '10' | '100' | '1,000' | '10,000' | '100,000' | '250,000' | '500,000' | '750,000' | '1,000,000' | '5,000,000' | '10,000,000+', required — Message Volume Enums
  - `optInConfirmationResponse` string, nullable — Message sent to users confirming their opt-in to receive messages
  - `optInKeywords` string, nullable — Keywords used to collect and process consumer opt-ins
  - `optInWorkflow` string, required — Human-readable description of how end users will opt into receiving messages from the given phone numbers
  - `optInWorkflowImageURLs` Url[], required — Images showing the opt-in workflow
    - `url` string, uri, required
  - `phoneNumbers` TFPhoneNumber[], required — The phone numbers to request the verification of
    - `phoneNumber` string, required
  - `privacyPolicyURL` string, nullable — URL pointing to the business's privacy policy. Plain string, no URL format validation.
  - `productionMessageContent` string, required — An example of a message that will be sent from the given phone numbers
  - `termsAndConditionURL` string, nullable — URL pointing to the business's terms and conditions. Plain string, no URL format validation.
  - `useCase` '2FA' | 'App Notifications' | 'Appointments' | 'Auctions' | 'Auto Repair Services' | 'Bank Transfers' | 'Billing' | 'Booking Confirmations' | 'Business Updates' | 'COVID-19 Alerts' | 'Career Training' | 'Chatbot' | 'Conversational / Alerts' | 'Courier Services & Deliveries' | 'Emergency Alerts' | 'Events & Planning' | 'Financial Services' | 'Fraud Alerts' | 'Fundraising' | 'General Marketing' | 'General School Updates' | 'HR / Staffing' | 'Healthcare Alerts' | 'Housing Community Updates' | 'Insurance Services' | 'Job Dispatch' | 'Legal Services' | 'Mixed' | 'Motivational Reminders' | 'Notary Notifications' | 'Order Notifications' | 'Political' | 'Public Works' | 'Real Estate Services' | 'Religious Services' | 'Repair and Diagnostics Alerts' | 'Rewards Program' | 'Surveys' | 'System Alerts' | 'Voting Reminders' | 'Waitlist Alerts' | 'Webinar Reminders' | 'Workshop Alerts', required — Tollfree usecase categories
  - `useCaseSummary` string, required — Human-readable summary of the desired use-case
  - `webhookUrl` string — URL that should receive webhooks relating to this verification request

## Response `200`

Successful Response

- TollFreeVerificationVerificationRequestEgress — A verification request as it comes out of the database
  - `additionalInformation` string, required
  - `ageGatedContent` boolean
  - `businessAddr1` string, required
  - `businessAddr2` string
  - `businessCity` string, required
  - `businessContactEmail` string, required
  - `businessContactFirstName` string, required
  - `businessContactLastName` string, required
  - `businessContactPhone` string, required
  - `businessName` string, required
  - `businessRegistrationCountry` string
  - `businessRegistrationNumber` string
  - `businessRegistrationType` string
  - `businessState` string, required
  - `businessZip` string, required
  - `campaignVerifyAuthorizationToken` string, nullable — Campaign Verify Authorization Token required for Political use case submissions starting February 17, 2026
  - `corporateWebsite` string, required
  - `doingBusinessAs` string
  - `entityType` 'SOLE_PROPRIETOR' | 'PRIVATE_PROFIT' | 'PUBLIC_PROFIT' | 'NON_PROFIT' | 'GOVERNMENT' — Business entity classification
  - `helpMessageResponse` string
  - `id` string, uuid, required
  - `isvReseller` string
  - `messageVolume` '10' | '100' | '1,000' | '10,000' | '100,000' | '250,000' | '500,000' | '750,000' | '1,000,000' | '5,000,000' | '10,000,000+', required — Message Volume Enums
  - `optInConfirmationResponse` string
  - `optInKeywords` string
  - `optInWorkflow` string, required
  - `optInWorkflowImageURLs` Url[], required
    - `url` string, uri, required
  - `phoneNumbers` TFPhoneNumber[], required
    - `phoneNumber` string, required
  - `privacyPolicyURL` string
  - `productionMessageContent` string, required
  - `termsAndConditionURL` string
  - `useCase` '2FA' | 'App Notifications' | 'Appointments' | 'Auctions' | 'Auto Repair Services' | 'Bank Transfers' | 'Billing' | 'Booking Confirmations' | 'Business Updates' | 'COVID-19 Alerts' | 'Career Training' | 'Chatbot' | 'Conversational / Alerts' | 'Courier Services & Deliveries' | 'Emergency Alerts' | 'Events & Planning' | 'Financial Services' | 'Fraud Alerts' | 'Fundraising' | 'General Marketing' | 'General School Updates' | 'HR / Staffing' | 'Healthcare Alerts' | 'Housing Community Updates' | 'Insurance Services' | 'Job Dispatch' | 'Legal Services' | 'Mixed' | 'Motivational Reminders' | 'Notary Notifications' | 'Order Notifications' | 'Political' | 'Public Works' | 'Real Estate Services' | 'Religious Services' | 'Repair and Diagnostics Alerts' | 'Rewards Program' | 'Surveys' | 'System Alerts' | 'Voting Reminders' | 'Waitlist Alerts' | 'Webinar Reminders' | 'Workshop Alerts', required — Tollfree usecase categories
  - `useCaseSummary` string, required
  - `verificationRequestId` string, required
  - `verificationStatus` 'Verified' | 'Rejected' | 'Waiting For Vendor' | 'Waiting For Customer' | 'Waiting For Telnyx' | 'In Progress' — Tollfree verification status
  - `webhookUrl` string

## Other responses

- `4XX` — Generic error response

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/3fdc16374d70/schema)