---
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

- TFVerificationRequest — The body of a tollfree verification request
  - `businessName` string, required — Name of the business; there are no specific formatting requirements
  - `corporateWebsite` string, required — A URL, including the scheme, pointing to the corporate website
  - `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
  - `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
  - `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
  - `businessContactEmail` string, required — The email address of the business contact
  - `businessContactPhone` string, required — The phone number of the business contact in E.164 format
  - `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
  - `phoneNumbers` TFPhoneNumber[], required — The phone numbers to request the verification of
    - `phoneNumber` string, required
  - `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
  - `productionMessageContent` string, required — An example of a message that will be sent from the given phone numbers
  - `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
  - `additionalInformation` string, required — Any additional information
  - `isvReseller` string, nullable — ISV name
  - `webhookUrl` string — URL that should receive webhooks relating to this verification request
  - `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.
  - `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.
  - `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
  - `optInConfirmationResponse` string, nullable — Message sent to users confirming their opt-in to receive messages
  - `helpMessageResponse` string, nullable — The message returned when users text 'HELP'
  - `privacyPolicyURL` string, nullable — URL pointing to the business's privacy policy. Plain string, no URL format validation.
  - `termsAndConditionURL` string, nullable — URL pointing to the business's terms and conditions. Plain string, no URL format validation.
  - `ageGatedContent` boolean — Indicates if messaging content requires age gating (e.g., 18+). Defaults to false if not provided.
  - `optInKeywords` string, nullable — Keywords used to collect and process consumer opt-ins
  - `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.

## Response `200`

Successful Response

- VerificationRequestEgress — A verification request as it comes out of the database
  - `businessName` string, required
  - `corporateWebsite` string, required
  - `businessAddr1` string, required
  - `businessAddr2` string
  - `businessCity` string, required
  - `businessState` string, required
  - `businessZip` string, required
  - `businessContactFirstName` string, required
  - `businessContactLastName` string, required
  - `businessContactEmail` string, required
  - `businessContactPhone` string, required
  - `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
  - `phoneNumbers` TFPhoneNumber[], required
    - `phoneNumber` string, required
  - `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
  - `productionMessageContent` string, required
  - `optInWorkflow` string, required
  - `optInWorkflowImageURLs` Url[], required
    - `url` string, uri, required
  - `additionalInformation` string, required
  - `isvReseller` string
  - `webhookUrl` string
  - `businessRegistrationNumber` string
  - `businessRegistrationType` string
  - `businessRegistrationCountry` string
  - `doingBusinessAs` string
  - `entityType` 'SOLE_PROPRIETOR' | 'PRIVATE_PROFIT' | 'PUBLIC_PROFIT' | 'NON_PROFIT' | 'GOVERNMENT' — Business entity classification
  - `optInConfirmationResponse` string
  - `helpMessageResponse` string
  - `privacyPolicyURL` string
  - `termsAndConditionURL` string
  - `ageGatedContent` boolean
  - `optInKeywords` string
  - `campaignVerifyAuthorizationToken` string, nullable — Campaign Verify Authorization Token required for Political use case submissions starting February 17, 2026
  - `id` string, uuid, required
  - `verificationRequestId` string, required
  - `verificationStatus` 'Verified' | 'Rejected' | 'Waiting For Vendor' | 'Waiting For Customer' | 'Waiting For Telnyx' | 'In Progress' — Tollfree verification status

## Other responses

- `4XX` — Generic error response

---

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