Update toll free verification
update_toll_free_verificationChange a toll-free verification: send only the fields to change. Allowed while draft, in_review (until it goes to the carriers) and rejected; after a rejection, fix what it asks for, then submit again.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>"
},
"name": "update_toll_free_verification"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Toll-free verification id (tfv_...) | |
| ein | No | The EIN (US), matching the legal name; elsewhere the business registration number. | |
| city | No | City. | |
| state | No | State or province code. | |
| street | No | Street address of the business. | |
| country | No | Country of the business. | |
| numbers | No | Your live toll-free numbers this program texts from, E.164. One per business unless multiple_numbers_reason says why. | |
| website | No | The business's website. | |
| use_case | No | What the texts are for. | |
| terms_url | No | The terms page, with the SMS program terms. | |
| help_reply | No | The reply to HELP: names the business and how to reach it. Omit to keep ours. | |
| opt_in_url | No | The opt-in page. With none of your own we make you a hosted one. | |
| stop_reply | No | The reply to STOP: names the business and says they are unsubscribed. Omit to keep ours. | |
| advertising | No | Whether the messages advertise a product or service. | |
| brand_email | No | The business's own email, for its customers: the HELP reply and the hosted opt-in page name it. | |
| entity_type | No | The kind of business. | |
| fortune_500 | No | The company is in the Fortune 500. | |
| postal_code | No | ZIP or postal code. | |
| privacy_url | No | The privacy policy page. | |
| volume_basis | No | existing: what it sends today. projecting: an estimate. | |
| business_name | No | The legal name, as on the IRS EIN letter, optionally with "d/b/a" and the brand your messages carry. | |
| contact_phone | No | A phone number they answer. | |
| monthly_volume | No | How many texts a month this program sends. | |
| sample_messages | No | At least two example messages. | |
| number_published | No | Where people see this number. | |
| previous_content | No | Sample messages from the previous service (not new only). | |
| previous_numbers | No | The numbers it used (not new only). | |
| previous_service | No | Where this traffic ran before. | |
| urls_in_messages | No | Links your messages include, or "None". | |
| use_case_summary | No | What the program sends, to whom and why. At least 40 characters. | |
| contact_last_name | No | Their last name. | |
| contact_first_name | No | First name of the person the carriers can contact about this program. | |
| opt_in_description | No | How people opt in, step by step. At least 40 characters. | |
| phones_in_messages | No | Phone numbers your messages include, or "None". | |
| opt_in_screenshot_url | No | A public image of the step where people enter their number and agree. Needed when the opt-in page itself has no phone field, like a later step of a form or an app. | |
| multiple_numbers_reason | No | Why the program needs more than one number (one per store, say). Required with more than one number. |