← The evidence ledger
Evidence row 1053659
Observed , by probe.mcp/1.
- Kind
- mcp.tools
- About
- endpoint af3c9bd5-b207-4dc1-b10b-34d79fe56a48
- Recorded
- Previous row
- #1014410
- Body SHA-256
- 43044371725adba3d400f76a88a101d3a5e09b16aca6a84c62c08157bcde3a81
- Leaf
- 0x1fd0a7042f4460edc5f64e150328dc5a80cbfccba72468f9a99b1bcca3d055fa
What was observed
{
"count": 148,
"tools": [
{
"description": "Turn an automation on, so tracked events start runs. With a live number it texts real people.",
"inputSchema": {
"properties": {
"id": {
"description": "Automation id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "activate_automation"
},
{
"description": "Add contacts to a list by contact_ids and/or phone_numbers (up to 1,000; numbers must already be contacts).",
"inputSchema": {
"properties": {
"contact_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"id": {
"description": "List id",
"type": "string"
},
"phone_numbers": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "add_to_list"
},
{
"description": "Platforms: attribute a number (and its messages and usage) to one of your customers, or clear it with customer_id null.",
"inputSchema": {
"properties": {
"customer_id": {
"description": "A customer id, or null to unassign",
"nullable": true,
"type": "string"
},
"phone_number": {
"description": "E.164 number you own",
"type": "string"
}
},
"required": [
"phone_number",
"customer_id"
],
"type": "object"
},
"name": "assign_number_to_customer"
},
{
"description": "Buy several numbers in one area code at once (e.g. for a sender pool). Live numbers are billed monthly each.",
"inputSchema": {
"properties": {
"area_code": {
"type": "string"
},
"idempotency_key": {
"description": "Optional. Retries are already safe: the same call with the same inputs within 10 minutes is done once and answers with the first result. Pass your own key to dedupe across a longer gap, or a new one to repeat an identical call on purpose.",
"maxLength": 200,
"type": "string"
},
"pool_id": {
"description": "Add the new numbers to this pool",
"type": "string"
},
"quantity": {
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"tags": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"area_code",
"quantity"
],
"type": "object"
},
"name": "bulk_purchase_numbers"
},
{
"description": "Add tags to, remove tags from, or delete many contacts by id.",
"inputSchema": {
"properties": {
"action": {
"enum": [
"add_tags",
"remove_tags",
"delete"
],
"type": "string"
},
"ids": {
"items": {
"type": "string"
},
"maxItems": 500,
"type": "array"
},
"tags": {
"description": "Required for add_tags and remove_tags",
"items": {
"maxLength": 40,
"type": "string"
},
"type": "array"
}
},
"required": [
"action",
"ids"
],
"type": "object"
},
"name": "bulk_update_contacts"
},
{
"description": "Act on many numbers at once: tag, untag, assign to a customer, or release. Releasing cannot be undone.",
"inputSchema": {
"properties": {
"action": {
"enum": [
"add_to_pool",
"remove_from_pool",
"add_tags",
"remove_tags",
"set_label",
"release"
],
"type": "string"
},
"confirm": {
"description": "release only",
"type": "string"
},
"ids": {
"items": {
"type": "string"
},
"maxItems": 1000,
"type": "array"
},
"label": {
"description": "set_label; null clears",
"maxLength": 64,
"nullable": true,
"type": "string"
},
"pool_id": {
"description": "add_to_pool / remove_from_pool",
"type": "string"
},
"tags": {
"description": "add_tags / remove_tags. Lowercased; up to 20 per number.",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ids",
"action"
],
"type": "object"
},
"name": "bulk_update_numbers"
},
{
"description": "Cancel a run in progress.",
"inputSchema": {
"properties": {
"id": {
"description": "Automation id",
"type": "string"
},
"run_id": {
"description": "Run id",
"type": "string"
}
},
"required": [
"id",
"run_id"
],
"type": "object"
},
"name": "cancel_automation_run"
},
{
"description": "Cancel a batch. Messages already sent stay sent.",
"inputSchema": {
"properties": {
"id": {
"description": "Batch id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "cancel_batch"
},
{
"description": "Cancel a scheduled message before it sends.",
"inputSchema": {
"properties": {
"id": {
"description": "Scheduled message id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "cancel_scheduled_message"
},
{
"description": "Check a verification code submitted by a user, by the phone or email it went to. Returns {verified, status, channel, charged}. Billed only when verified is true.",
"inputSchema": {
"properties": {
"code": {
"description": "The code last sent",
"type": "string"
},
"email": {
"description": "The address the code was emailed to. After a fallback, check by `email`: the code proves the address, not the phone, and a check by `phone` answers 409 `invalid_state`.",
"type": "string"
},
"phone": {
"description": "The number the code was texted to. Send this or `email`.",
"type": "string"
}
},
"required": [
"code"
],
"type": "object"
},
"name": "check_verification"
},
{
"description": "Copy a sender pool under a new name.",
"inputSchema": {
"properties": {
"id": {
"description": "Pool id",
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "clone_number_pool"
},
{
"description": "Connect a tool so its people sync in as contacts, in a list of their own, every 6 hours: Mixpanel (projectId, username, secret = a service account; sourceId = cohort id), Amplitude (apiKey, secretKey, sourceId), HubSpot (accessToken), Shopify (shopDomain, accessToken), Salesforce, or a webhook. Takes the event or property that shows people agreed to texts (consentEvent / consentField) and the property that holds their phone (phoneField). Credentials are proved with one read, sealed, and never returned. Mixpanel also takes eventTriggers, which turn Mixpanel events into TextKit events that start, end or branch automations; `warnings` names mapped events with no volume in 7 days.",
"inputSchema": {
"properties": {
"accessToken": {
"description": "HubSpot private app token, or Shopify Admin API access token.",
"type": "string"
},
"apiKey": {
"description": "Amplitude API key.",
"type": "string"
},
"clientId": {
"description": "Salesforce consumer key, or Shopify client id.",
"type": "string"
},
"clientSecret": {
"description": "Salesforce consumer secret, or Shopify client secret.",
"type": "string"
},
"consentEvent": {
"description": "Mixpanel / Amplitude: the opt-in event the cohort is built on (e.g. SMS Opt In). Everyone in the cohort is recorded as opted in, from that event.",
"type": "string"
},
"consentField": {
"description": "The tool's property that records SMS consent (e.g. sms_opt_in).",
"type": "string"
},
"eventTriggers": {
"description": "Mixpanel (with a service account): events to turn into TextKit events within about 10 minutes, so automations start, wait and branch on them. Each entry is a TextKit event name and the Mixpanel events that count as it, like { event: \"purchase_completed\", mixpanel_events: [\"Purchase Completed\", \"Web Trial Successful\"] }. Only events from people in the integration's list become events, matched by their Mixpanel id. [] clears them. The answer's `warnings` names mapped events that fired 0 times in the last 7 days.",
"items": {
"properties": {
"event": {
"type": "string"
},
"mixpanel_events": {
"items": {
"type": "string"
},
"maxItems": 10,
"type": "array"
}
},
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"instanceUrl": {
"description": "Salesforce My Domain URL.",
"type": "string"
},
"mode": {
"description": "Mixpanel / Amplitude: pull with credentials every 6 hours (default when credentials are sent), or push: no credentials, the tool's cohort sync posts to the ingest URL.",
"enum": [
"pull",
"push"
],
"type": "string"
},
"name": {
"description": "What to call it (default: the tool and its source).",
"type": "string"
},
"phoneEvent": {
"description": "Mixpanel: an event that carries the number when profiles do not (e.g. Verification Check Success). A member with no phone on the profile gets it from their latest such event.",
"type": "string"
},
"phoneEventProperty": {
"description": "Mixpanel: that event's property holding the number (default phone).",
"type": "string"
},
"phoneField": {
"description": "The tool's property holding the mobile number, when not the usual one ($phone, phone, mobilephone).",
"type": "string"
},
"projectId": {
"description": "Mixpanel project id.",
"type": "string"
},
"provider": {
"enum": [
"shopify",
"hubspot",
"salesforce",
"mixpanel",
"amplitude",
"webhook"
],
"type": "string"
},
"region": {
"description": "Mixpanel / Amplitude data residency.",
"enum": [
"us",
"eu"
],
"type": "string"
},
"secret": {
"description": "Mixpanel service account secret.",
"type": "string"
},
"secretKey": {
"description": "Amplitude secret key.",
"type": "string"
},
"sfObject": {
"enum": [
"Contact",
"Lead"
],
"type": "string"
},
"shopDomain": {
"description": "Shopify store, like acme.myshopify.com.",
"type": "string"
},
"sourceId": {
"description": "Mixpanel or Amplitude cohort id; HubSpot list id; Salesforce campaign id; a Shopify customer search. Blank = everyone (HubSpot, Shopify, Salesforce).",
"type": "string"
},
"username": {
"description": "Mixpanel service account username.",
"type": "string"
}
},
"required": [
"provider"
],
"type": "object"
},
"name": "connect_integration"
},
{
"description": "Create an API key for an app you are building, to store as a secret in its environment (for example TEXTKIT_API_KEY) so the app can send texts itself. Same mode (test or live) as this connection; optional scopes limit it. The secret is returned once; the account owner is emailed.",
"inputSchema": {
"properties": {
"name": {
"description": "What the key is for, e.g. \"Booking app\"",
"maxLength": 60,
"type": "string"
},
"scopes": {
"description": "Limit the key to these scopes (see /docs/authentication). Omit for full access (full-access callers only).",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "create_api_key"
},
{
"description": "Create a triggered text flow (as a draft): when trigger.event is tracked, run steps such as send_sms, wait, wait_for_event, and condition branches. Example: on cart_abandoned, wait 3600s, then if checkout_completed was not received send a reminder. Settle with the person first: the starting event, how long after it to text, the event that ends it, follow-ups, who gets it and the message. For events that repeat, trigger.cooldown_seconds stops the same person starting it again for that long. Merge fields like {{plan}} fill from the trigger event's properties; `issues` names any no tracked event carries. Drafts send nothing until activated.",
"inputSchema": {
"properties": {
"from": {
"description": "One of your numbers. A sandbox number makes it a sandbox flow.",
"nullable": true,
"type": "string"
},
"name": {
"maxLength": 80,
"type": "string"
},
"steps": {
"items": {
"description": "One of: send_sms {body, from?}; wait {seconds}; wait_for_event {event, timeout_seconds, on_received, on_timeout}; condition {check, on_met, on_not_met}; end. Branches are \"continue\", \"end\", or \"goto:<id of a later step>\".",
"properties": {
"body": {
"description": "send_sms. Merge fields: event properties by name, {{first_name}}, {{name}}, {{phone}}, {{field:<custom>}}.",
"maxLength": 1600,
"type": "string"
},
"check": {
"description": "{kind: event_received, event} | {kind: property, property, op, value?} | {kind: contact_field, field, op, value?}. op: eq, neq, contains, gt, lt, exists, not_exists.",
"type": "object"
},
"event": {
"type": "string"
},
"from": {
"description": "send_sms: overrides the flow sender.",
"type": "string"
},
"id": {
"description": "Stable handle for goto branches; assigned when omitted.",
"type": "string"
},
"on_met": {
"type": "string"
},
"on_not_met": {
"type": "string"
},
"on_received": {
"type": "string"
},
"on_timeout": {
"type": "string"
},
"seconds": {
"maximum": 2592000,
"minimum": 60,
"type": "integer"
},
"timeout_seconds": {
"maximum": 2592000,
"minimum": 60,
"type": "integer"
},
"type": {
"enum": [
"send_sms",
"wait",
"wait_for_event",
"condition",
"end"
],
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"topic_id": {
"description": "Skip recipients unsubscribed from this topic.",
"nullable": true,
"type": "string"
},
"trigger": {
"properties": {
"cooldown_seconds": {
"description": "Optional. After a run starts for a person, they do not start another for this long (for events that repeat, like a paywall view).",
"maximum": 7776000,
"minimum": 60,
"type": "integer"
},
"event": {
"type": "string"
},
"filters": {
"items": {
"properties": {
"op": {
"type": "string"
},
"property": {
"type": "string"
},
"value": {}
},
"type": "object"
},
"maxItems": 5,
"type": "array"
}
},
"type": "object"
}
},
"type": "object"
},
"name": "create_automation"
},
{
"description": "Platforms sending for other businesses: create a customer to attribute numbers, messages and usage to.",
"inputSchema": {
"properties": {
"external_id": {
"description": "Your id for them; unique per account",
"maxLength": 200,
"nullable": true,
"type": "string"
},
"metadata": {
"additionalProperties": {
"maxLength": 500,
"type": "string"
},
"description": "Up to 50 string values",
"type": "object"
},
"name": {
"maxLength": 200,
"nullable": true,
"type": "string"
}
},
"type": "object"
},
"name": "create_customer"
},
{
"description": "Add a subdomain of the user's own (links.example.com) for short links. Returns two DNS records (CNAME and TXT) the user adds at their DNS host; then verify the domain. Short links never go on a shared domain: carriers filter those.",
"inputSchema": {
"properties": {
"domain": {
"type": "string"
}
},
"required": [
"domain"
],
"type": "object"
},
"name": "create_link_domain"
},
{
"description": "Create a list: a fixed group of contacts (Audience → Lists). Use a list when the user names exactly who belongs (\"add these people to VIPs\"); use a segment when membership follows rules.",
"inputSchema": {
"properties": {
"description": {
"maxLength": 200,
"nullable": true,
"type": "string"
},
"name": {
"maxLength": 80,
"type": "string"
}
},
"type": "object"
},
"name": "create_list"
},
{
"description": "Create a sender pool from numbers you own.",
"inputSchema": {
"properties": {
"description": {
"maxLength": 280,
"type": "string"
},
"name": {
"maxLength": 64,
"type": "string"
},
"routing": {
"default": "sticky",
"description": "How a recipient gets a number. sticky: the same member every time. local: a member in the recipient's area code, else one in their time zone, else any; still the same one each time.",
"enum": [
"sticky",
"local"
],
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "create_number_pool"
},
{
"description": "Send the same text to one number every day, week or month at a local time (e.g. a weekly reminder). Every occurrence runs the usual send checks.",
"inputSchema": {
"properties": {
"body": {
"maxLength": 1600,
"type": "string"
},
"category": {
"description": "Optional. It can make each occurrence stricter (`marketing`), never looser: the sending number's registration and the wording decide ([which messages are marketing](/docs/compliance-checks#which-messages-are-marketing)).",
"enum": [
"marketing",
"transactional",
"otp"
],
"nullable": true,
"type": "string"
},
"end_date": {
"description": "Last local date it may run (inclusive).",
"format": "date",
"nullable": true,
"type": "string"
},
"from": {
"description": "One of your numbers. Optional when the account has exactly one number for the key's mode.",
"type": "string"
},
"idempotency_key": {
"description": "Optional. Retries are already safe: the same call with the same inputs within 10 minutes is done once and answers with the first result. Pass your own key to dedupe across a longer gap, or a new one to repeat an identical call on purpose.",
"maxLength": 200,
"type": "string"
},
"max_occurrences": {
"description": "The schedule completes after this many messages have been sent.",
"minimum": 1,
"nullable": true,
"type": "integer"
},
"quiet_hours": {
"description": "Optional. What to do with a message in the recipient's quiet hours: `block` refuses it (403 quiet_hours), `defer` holds it until their next 8:00am. Omitted: an occurrence in quiet hours is held until the recipient's 8:00am and recorded as `deferred`.",
"enum": [
"block",
"defer"
],
"nullable": true,
"type": "string"
},
"repeat": {
"properties": {
"day_of_month": {
"description": "Monthly only, required. Months without that day run on their last day.",
"maximum": 31,
"minimum": 1,
"type": "integer"
},
"days_of_week": {
"description": "Weekly only, required: which weekdays.",
"items": {
"enum": [
"sun",
"mon",
"tue",
"wed",
"thu",
"fri",
"sat"
],
"type": "string"
},
"type": "array"
},
"frequency": {
"enum": [
"daily",
"weekly",
"monthly"
],
"type": "string"
},
"time": {
"description": "24-hour wall-clock time, HH:MM, in `timezone`.",
"type": "string"
},
"timezone": {
"description": "IANA time zone.",
"type": "string"
}
},
"required": [
"frequency",
"time",
"timezone"
],
"type": "object"
},
"start_date": {
"description": "First local date it may run. Defaults to today.",
"format": "date",
"nullable": true,
"type": "string"
},
"to": {
"type": "string"
}
},
"required": [
"to",
"body",
"repeat"
],
"type": "object"
},
"name": "create_schedule"
},
{
"description": "Save an audience (a segment, a cohort): it appears in the console under Audience → Segments, and broadcasts can be sent to it. Everyone who can be texted: one rule, status is subscribed. Contacts matching all (or any) of up to 10 rules. Attributes: tags, contact fields, custom fields (field = \"field\", key = the name), opt-in status, topic, import, created_at. Behaviour: last_message_at, last_reply_at, batch (key = batch id; value included, sent, failed, skipped or replied) and event (key = a tracked event name). Times take an ISO date or a window like 7d. It is evaluated live each time it is used, so a batch or list sent to it reaches whoever matches then.",
"inputSchema": {
"properties": {
"description": {
"maxLength": 200,
"nullable": true,
"type": "string"
},
"match": {
"default": "all",
"enum": [
"all",
"any"
],
"type": "string"
},
"name": {
"maxLength": 80,
"type": "string"
},
"rules": {
"items": {
"properties": {
"field": {
"description": "Attributes: tag, the name and profile fields, source, field (a custom field), import, status (opt-out), topic, list (in a static list), created_at. Behaviour: last_message_at (last text either way), last_reply_at (last text from them), batch (what happened to them in one batch), event (a tracked event; the newest 20,000 events are searched).",
"enum": [
"tag",
"first_name",
"last_name",
"name",
"email",
"company",
"state",
"source",
"field",
"import",
"status",
"topic",
"created_at",
"last_message_at",
"last_reply_at",
"batch",
"event",
"list"
],
"type": "string"
},
"key": {
"description": "The custom field name (field), topic id (topic), batch id (batch), or event name (event)",
"type": "string"
},
"op": {
"description": "Text fields take is / is_not / contains / not_contains / exists / not_exists; tag takes is / is_not / exists / not_exists; status, topic, import, batch and list take is / is_not; created_at takes before / after; last_message_at, last_reply_at and event take after (at or after the time), before (it happened, and the last time was before it), exists (ever) and not_exists (never). Comparisons ignore case.",
"enum": [
"is",
"is_not",
"contains",
"not_contains",
"exists",
"not_exists",
"before",
"after"
],
"type": "string"
},
"value": {
"description": "status: subscribed or opted_out. topic: subscribed or unsubscribed. import: an import id. list: a list id (lst_...). batch: included, sent, failed, skipped or replied (sent, then texted the batch's number after it was created). Times (created_at, last_message_at, last_reply_at, event): an ISO date, or a window back from now such as 7d or 24h, read each time the segment is used.",
"type": "string"
}
},
"required": [
"field"
],
"type": "object"
},
"maxItems": 10,
"type": "array"
}
},
"type": "object"
},
"name": "create_segment"
},
{
"description": "Save a message template. Merge tags: {{first_name}}, {{name}}, {{phone}}, {{field:<custom>}}, and per-recipient variables.",
"inputSchema": {
"properties": {
"body": {
"maxLength": 1600,
"type": "string"
},
"name": {
"maxLength": 60,
"type": "string"
}
},
"required": [
"name",
"body"
],
"type": "object"
},
"name": "create_template"
},
{
"description": "Create a subscription topic, so people can opt out of one kind of message (e.g. promotions) and keep others.",
"inputSchema": {
"properties": {
"description": {
"maxLength": 200,
"nullable": true,
"type": "string"
},
"name": {
"maxLength": 60,
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "create_topic"
},
{
"description": "Send events (message.received, message.delivered, message.opted_out, ...) to a URL: your app, a CRM, an automation tool. Returns the signing secret once.",
"inputSchema": {
"properties": {
"description": {
"maxLength": 120,
"type": "string"
},
"events": {
"description": "Event types to receive. Omit, or send \"*\" or [], for every event. An unknown type is a 400.",
"oneOf": [
{
"enum": [
"*"
],
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
}
]
},
"numbers": {
"description": "Optional. Only events about these of your numbers (E.164): message events by their from/to, number events by phone_number. Events about no number (batches, credits, registrations) go only to endpoints without a filter. Omit or [] for every number.",
"items": {
"type": "string"
},
"maxItems": 100,
"type": "array"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "create_webhook"
},
{
"description": "Delete an automation.",
"inputSchema": {
"properties": {
"id": {
"description": "Automation id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "delete_automation"
},
{
"description": "Delete a contact. Messages, consent records, and topic preferences for the number are kept.",
"inputSchema": {
"properties": {
"id": {
"description": "Contact id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "delete_contact"
},
{
"description": "Delete a customer.",
"inputSchema": {
"properties": {
"id": {
"description": "Customer id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "delete_customer"
},
{
"description": "Remove a branded link domain. Every short link already sent on it stops working.",
"inputSchema": {
"properties": {
"id": {
"description": "Link domain id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "delete_link_domain"
},
{
"description": "Delete a list (its contacts stay).",
"inputSchema": {
"properties": {
"id": {
"description": "List id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "delete_list"
},
{
"description": "Delete a finished message (delivered, failed or received) and every copy of its text, for a privacy request. Opt-out records and billing are kept. Cannot be undone.",
"inputSchema": {
"properties": {
"id": {
"description": "Message id (msg_...)",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "delete_message"
},
{
"description": "Delete a sender pool. Its numbers are kept.",
"inputSchema": {
"properties": {
"id": {
"description": "Pool id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "delete_number_pool"
},
{
"description": "Delete a recurring schedule.",
"inputSchema": {
"properties": {
"id": {
"description": "Schedule id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "delete_schedule"
},
{
"description": "Delete a segment. Contacts are not touched.",
"inputSchema": {
"properties": {
"id": {
"description": "Segment id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "delete_segment"
},
{
"description": "Delete a template.",
"inputSchema": {
"properties": {
"id": {
"description": "Template id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "delete_template"
},
{
"description": "Delete a topic you created (built-in topics stay).",
"inputSchema": {
"properties": {
"id": {
"description": "Topic id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "delete_topic"
},
{
"description": "Delete a webhook endpoint.",
"inputSchema": {
"properties": {
"id": {
"description": "Webhook endpoint id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "delete_webhook"
},
{
"description": "Disconnect a tool: its credentials and its list are deleted; the contacts stay with their consent.",
"inputSchema": {
"properties": {
"id": {
"description": "Integration id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "disconnect_integration"
},
{
"description": "The suppression list, or the full consent ledger with opt-in proof, as CSV text.",
"inputSchema": {
"properties": {
"type": {
"default": "suppressions",
"enum": [
"suppressions",
"ledger"
],
"type": "string"
}
},
"type": "object"
},
"name": "export_consent"
},
{
"description": "Export as CSV text for analysis: messages, deliveries, events, opt_outs, webhook_deliveries, usage, usage_monthly, audit_log or credit_history. At most 50,000 rows; narrow the date range with from and to.",
"inputSchema": {
"properties": {
"action": {
"description": "audit_log: one action, or a group prefix with a trailing dot (team.)",
"type": "string"
},
"actor": {
"description": "audit_log: actor id or part of the actor email",
"type": "string"
},
"batch": {
"description": "messages, deliveries: batch id (bc_...)",
"type": "string"
},
"blocked_reason": {
"description": "messages, deliveries: blocked messages with this reason",
"type": "string"
},
"created_after": {
"description": "audit_log: same as on GET /audit-logs (from is accepted too)",
"type": "string"
},
"created_before": {
"description": "audit_log: same as on GET /audit-logs (to is accepted too)",
"type": "string"
},
"customer_id": {
"description": "messages, deliveries",
"type": "string"
},
"direction": {
"description": "messages",
"enum": [
"outbound",
"inbound"
],
"type": "string"
},
"endpoint_id": {
"description": "webhook_deliveries (default: all endpoints)",
"type": "string"
},
"failure_code": {
"description": "messages, deliveries: failed for this reason (the `failure.code` on a message)",
"enum": [
"carrier_filtered",
"unreachable",
"invalid_number",
"opted_out",
"campaign_mismatch",
"content_blocked",
"screen_unavailable",
"rate_limited",
"landline",
"carrier_rejected",
"spend_limit_reached",
"insufficient_credits",
"billing_required",
"sender_not_registered",
"quiet_hours",
"consent_required",
"reconfirmation_pending",
"reconfirmation_expired",
"held_for_review",
"review_rejected",
"review_expired",
"campaign_paused",
"sender_rotation",
"recipient_not_verified",
"quota_exceeded",
"destination_not_allowed",
"voip_number",
"toll_free_destination",
"toll_free_unverified",
"account_closed",
"account_suspended",
"account_paused",
"topic_unsubscribed",
"unknown"
],
"type": "string"
},
"from": {
"description": "ISO date/time or epoch ms (messages, deliveries, events, webhook_deliveries)",
"type": "string"
},
"from_number": {
"description": "messages, deliveries: exact sender (E.164)",
"type": "string"
},
"kind": {
"description": "messages, deliveries, events, opt_outs, webhook_deliveries, usage, usage_monthly, audit_log or credit_history",
"type": "string"
},
"months": {
"default": 3,
"description": "usage: daily rows for the last N months",
"maximum": 12,
"minimum": 1,
"type": "integer"
},
"number": {
"description": "messages, deliveries: digits matched against either side",
"type": "string"
},
"ok": {
"description": "webhook_deliveries",
"type": "boolean"
},
"q": {
"description": "messages: body/failure text; events: id/payload text",
"type": "string"
},
"status": {
"description": "messages, deliveries",
"enum": [
"queued",
"sent",
"delivered",
"failed",
"blocked",
"received"
],
"type": "string"
},
"target_type": {
"description": "audit_log",
"type": "string"
},
"to": {
"description": "Inclusive; a bare date means the end of that day (UTC)",
"type": "string"
},
"to_number": {
"description": "messages, deliveries: exact recipient (E.164). `to`/`from` are the date range here.",
"type": "string"
},
"type": {
"description": "events, webhook_deliveries",
"type": "string"
}
},
"required": [
"kind"
],
"type": "object"
},
"name": "export_csv"
},
{
"description": "Your numbers as CSV text.",
"inputSchema": {
"properties": {
"mode": {
"enum": [
"test",
"live"
],
"type": "string"
},
"pool": {
"type": "string"
},
"q": {
"type": "string"
},
"tag": {
"type": "string"
}
},
"type": "object"
},
"name": "export_numbers"
},
{
"description": "The text did not arrive: email a new code for the same pending verification (one id, one charge). The emailed code replaces the texted one and is checked by the email address, which it proves (not the phone). Once per verification.",
"inputSchema": {
"properties": {
"channel": {
"default": "email",
"description": "The channel to fall back to. Only `email` today.",
"enum": [
"email"
],
"type": "string"
},
"email": {
"description": "The address to email the code to",
"type": "string"
},
"id": {
"description": "Verification id (ver_...)",
"type": "string"
},
"user_ip": {
"description": "Optional. Your end user's IP address, counted in the same per-IP limit as POST /verify.",
"type": "string"
}
},
"required": [
"id",
"email"
],
"type": "object"
},
"name": "fallback_verification"
},
{
"description": "Privacy erasure: forget the phone number linked to a user_id, so its tracked events stop reaching automations.",
"inputSchema": {
"properties": {
"user_id": {
"description": "Your user id",
"type": "string"
}
},
"required": [
"user_id"
],
"type": "object"
},
"name": "forget_identity"
},
{
"description": "Retrieve an automation with its trigger and steps.",
"inputSchema": {
"properties": {
"id": {
"description": "Automation id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_automation"
},
{
"description": "Retrieve one run with its step-by-step timeline.",
"inputSchema": {
"properties": {
"id": {
"description": "Automation id",
"type": "string"
},
"run_id": {
"description": "Run id",
"type": "string"
}
},
"required": [
"id",
"run_id"
],
"type": "object"
},
"name": "get_automation_run"
},
{
"description": "Prepaid credit balance and auto-recharge setting.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "get_balance"
},
{
"description": "Retrieve a batch with its progress counts.",
"inputSchema": {
"properties": {
"id": {
"description": "Batch id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_batch"
},
{
"description": "Results of a batch: delivered, failed, pending, replies, opt-outs (stops), spend, and failures grouped by reason.",
"inputSchema": {
"properties": {
"id": {
"description": "Batch id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_batch_results"
},
{
"description": "Whether a number is opted in or out, per registration, with its full consent history and proof.",
"inputSchema": {
"properties": {
"phone": {
"description": "E.164 number",
"type": "string"
}
},
"required": [
"phone"
],
"type": "object"
},
"name": "get_consent"
},
{
"description": "Retrieve a contact.",
"inputSchema": {
"properties": {
"id": {
"description": "Contact id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_contact"
},
{
"description": "A contact's subscription to each topic.",
"inputSchema": {
"properties": {
"id": {
"description": "Contact id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_contact_topics"
},
{
"description": "Retrieve a customer.",
"inputSchema": {
"properties": {
"id": {
"description": "Customer id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_customer"
},
{
"description": "A customer's messages, verifications and spend for a period.",
"inputSchema": {
"properties": {
"end": {
"description": "Default: today",
"format": "date",
"type": "string"
},
"id": {
"description": "Customer id",
"type": "string"
},
"start": {
"description": "Default: first day of this month",
"format": "date",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_customer_usage"
},
{
"description": "Delivery rates by day, destination carrier, or sending number.",
"inputSchema": {
"properties": {
"end_date": {
"description": "YYYY-MM-DD",
"type": "string"
},
"group_by": {
"enum": [
"day",
"carrier",
"number"
],
"type": "string"
},
"start_date": {
"description": "YYYY-MM-DD",
"type": "string"
}
},
"type": "object"
},
"name": "get_deliverability"
},
{
"description": "One connected tool and its last sync.",
"inputSchema": {
"properties": {
"id": {
"description": "Integration id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_integration"
},
{
"description": "Confirm the events behind automations: for a Mixpanel integration, each mapped event with its Mixpanel source events and their 7-day volume, how many reached TextKit and when the last did, and which automations start on, wait for or check it. `missing` names events automations rely on that nothing sends. project_events: true also lists every Mixpanel event name with its 7-day volume, to choose what to map.",
"inputSchema": {
"properties": {
"id": {
"description": "Integration id",
"type": "string"
},
"project_events": {
"description": "Also list the Mixpanel project's event names with their 7-day volume.",
"type": "boolean"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_integration_events"
},
{
"description": "One short-link domain, with the DNS records it needs.",
"inputSchema": {
"properties": {
"id": {
"description": "Link domain id (ld_...)",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_link_domain"
},
{
"description": "Retrieve a list and its contact count.",
"inputSchema": {
"properties": {
"id": {
"description": "List id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_list"
},
{
"description": "Retrieve a message by its msg_... id, with its delivery timeline.",
"inputSchema": {
"properties": {
"id": {
"description": "Message id (msg_...)",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_message"
},
{
"description": "Retrieve one of your numbers: status, sender registration, tags, pools, customer.",
"inputSchema": {
"properties": {
"phone_number": {
"description": "E.164 number you own",
"type": "string"
}
},
"required": [
"phone_number"
],
"type": "object"
},
"name": "get_number"
},
{
"description": "Retrieve a sender pool and its numbers.",
"inputSchema": {
"properties": {
"id": {
"description": "Pool id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_number_pool"
},
{
"description": "A registration with its checks, status, and linked numbers.",
"inputSchema": {
"properties": {
"id": {
"description": "Registration id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_registration"
},
{
"description": "Retrieve a recurring schedule with its recent occurrences.",
"inputSchema": {
"properties": {
"id": {
"description": "Schedule id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_schedule"
},
{
"description": "Retrieve a pending scheduled message.",
"inputSchema": {
"properties": {
"id": {
"description": "Scheduled message id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_scheduled_message"
},
{
"description": "Retrieve a segment and its rules.",
"inputSchema": {
"properties": {
"id": {
"description": "Segment id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_segment"
},
{
"description": "The monthly spend limit and this month's estimated spend.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "get_spend_limit"
},
{
"description": "Retrieve a template.",
"inputSchema": {
"properties": {
"id": {
"description": "Template id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_template"
},
{
"description": "A toll-free verification: status, numbers, the form, what is missing (problems), and the carriers' reason when it was rejected.",
"inputSchema": {
"properties": {
"id": {
"description": "Toll-free verification id (tfv_...)",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_toll_free_verification"
},
{
"description": "Retrieve a topic.",
"inputSchema": {
"properties": {
"id": {
"description": "Topic id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_topic"
},
{
"description": "Usage by month, today's counters, and plan limits.",
"inputSchema": {
"properties": {
"months": {
"description": "How many months back (default 3)",
"type": "number"
}
},
"type": "object"
},
"name": "get_usage"
},
{
"description": "Retrieve a verification by id: its status and attempts (never the code).",
"inputSchema": {
"properties": {
"id": {
"description": "Verification id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_verification"
},
{
"description": "Retrieve a webhook endpoint.",
"inputSchema": {
"properties": {
"id": {
"description": "Webhook endpoint id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_webhook"
},
{
"description": "Create or update up to 500 contacts per call, matched by phone_number. Attributes go in fields (up to 20 strings, e.g. plan) for segments and {{field:name}} merge tags; tags group contacts. opt_in carries consent evidence (status: false records an opt-out). import_id from the first response groups several calls; dry_run: true returns what would change and writes nothing.",
"inputSchema": {
"properties": {
"campaign_id": {
"description": "Applies to every opt_in row that does not name its own campaign_id",
"type": "string"
},
"check_line_types": {
"description": "dry_run only. Looks up line types to count landlines; live lookups are paid, so only the first 500 numbers are checked.",
"type": "boolean"
},
"contacts": {
"items": {
"properties": {
"company": {
"maxLength": 120,
"type": "string"
},
"email": {
"maxLength": 254,
"type": "string"
},
"fields": {
"additionalProperties": {
"maxLength": 500,
"type": "string"
},
"description": "Up to 20 string values (account id, plan, location...), usable in segments and as {{field:key}} merge fields",
"type": "object"
},
"first_name": {
"maxLength": 80,
"type": "string"
},
"last_name": {
"maxLength": 80,
"type": "string"
},
"name": {
"description": "Display name. Defaults to first + last name.",
"maxLength": 120,
"type": "string"
},
"notes": {
"maxLength": 2000,
"type": "string"
},
"opt_in": {
"description": "Import only (POST /v1/contacts/import). Stored as consent evidence; never lifts an opt-out.",
"properties": {
"at": {
"description": "When they opted in: ISO timestamp, date, or epoch ms",
"type": "string"
},
"campaign_id": {
"description": "The registration the opt-in is for. A marketing or mixed registration needs at, a recognised source, and page_url for a web form, or the row is skipped",
"type": "string"
},
"page_url": {
"description": "The page a web-form opt-in was collected on",
"format": "uri",
"type": "string"
},
"source": {
"description": "web_form, keyword, paper, checkout or verbal are stored as proof; anything else is kept as a note",
"type": "string"
},
"status": {
"description": "true = opted in; false = unsubscribed (recorded as an opt-out)",
"type": "boolean"
}
},
"type": "object"
},
"phone_number": {
"description": "E.164, US or Canada",
"type": "string"
},
"source": {
"description": "Where the contact came from. Defaults to \"api\".",
"maxLength": 60,
"type": "string"
},
"state": {
"maxLength": 40,
"type": "string"
},
"tags": {
"items": {
"maxLength": 40,
"type": "string"
},
"maxItems": 20,
"type": "array"
}
},
"required": [
"phone_number"
],
"type": "object"
},
"maxItems": 500,
"type": "array"
},
"dry_run": {
"type": "boolean"
},
"import_id": {
"description": "From a previous response, to group several requests as one import.",
"type": "string"
},
"name": {
"description": "A label for the import (first request only).",
"type": "string"
}
},
"required": [
"contacts"
],
"type": "object"
},
"name": "import_contacts"
},
{
"description": "Bring a suppression list over from another provider or tool (up to 500 numbers per call), so people who opted out there are never texted here.",
"inputSchema": {
"properties": {
"phone_numbers": {
"items": {
"type": "string"
},
"maxItems": 500,
"type": "array"
}
},
"required": [
"phone_numbers"
],
"type": "object"
},
"name": "import_opt_outs"
},
{
"description": "Attach a number to an approved 10DLC registration so it can send that registration's traffic.",
"inputSchema": {
"properties": {
"phone_number": {
"description": "E.164 number you own",
"type": "string"
},
"registration_id": {
"type": "string"
}
},
"required": [
"phone_number",
"registration_id"
],
"type": "object"
},
"name": "link_number_to_registration"
},
{
"description": "List the active API keys of this mode (never the secrets).",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_api_keys"
},
{
"description": "Who changed what on the account (keys, team, webhooks, spend limit, numbers, consent, settings), newest first.",
"inputSchema": {
"properties": {
"action": {
"description": "One action, or a group prefix with a trailing dot (team., api_key.)",
"type": "string"
},
"actor": {
"description": "Actor id (exact) or part of the actor email (case-insensitive)",
"type": "string"
},
"created_after": {
"description": "Entries at or after this time (ISO 8601)",
"format": "date-time",
"type": "string"
},
"created_before": {
"description": "Entries at or before this time (ISO 8601); a bare date means the end of that day (UTC)",
"format": "date-time",
"type": "string"
},
"cursor": {
"type": "string"
},
"limit": {
"default": 25,
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"target_type": {
"description": "Target type, e.g. api_key, member, invite, webhook, number, phone",
"type": "string"
}
},
"type": "object"
},
"name": "list_audit_logs"
},
{
"description": "List an automation's runs, newest first.",
"inputSchema": {
"properties": {
"cursor": {
"description": "next_cursor from the previous page",
"type": "string"
},
"id": {
"description": "Automation id",
"type": "string"
},
"limit": {
"description": "Max results (default 25, max 100)",
"type": "number"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "list_automation_runs"
},
{
"description": "List automations.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_automations"
},
{
"description": "List a batch's recipients with each one's status.",
"inputSchema": {
"properties": {
"cursor": {
"description": "next_cursor from the previous page",
"type": "string"
},
"id": {
"description": "Batch id",
"type": "string"
},
"limit": {
"description": "Max results (default 25, max 100)",
"type": "number"
},
"status": {
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "list_batch_recipients"
},
{
"description": "List batches (broadcasts), newest first.",
"inputSchema": {
"properties": {
"cursor": {
"description": "next_cursor from the previous page",
"type": "string"
},
"limit": {
"description": "Max results (default 25, max 100)",
"type": "number"
},
"status": {
"type": "string"
}
},
"type": "object"
},
"name": "list_batches"
},
{
"description": "List contacts, newest first. Filter by tag, segment_id, list_id, exact phone_number, or a free-text q (name, email, company).",
"inputSchema": {
"properties": {
"cursor": {
"description": "next_cursor from the previous page",
"type": "string"
},
"limit": {
"description": "Max results (default 25, max 100)",
"type": "number"
},
"list_id": {
"type": "string"
},
"phone_number": {
"description": "E.164",
"type": "string"
},
"q": {
"description": "Search text",
"type": "string"
},
"segment_id": {
"type": "string"
},
"tag": {
"type": "string"
}
},
"type": "object"
},
"name": "list_contacts"
},
{
"description": "List your customers.",
"inputSchema": {
"properties": {
"cursor": {
"type": "string"
},
"external_id": {
"description": "Find the customer with this external_id (0 or 1 results)",
"type": "string"
},
"limit": {
"default": 25,
"maximum": 100,
"type": "integer"
}
},
"type": "object"
},
"name": "list_customers"
},
{
"description": "List recent events (message.sent/delivered/failed/received, number.purchased/released, ...), newest first.",
"inputSchema": {
"properties": {
"cursor": {
"description": "next_cursor from the previous page",
"type": "string"
},
"limit": {
"description": "Max results (default 25, max 100)",
"type": "number"
},
"type": {
"type": "string"
}
},
"type": "object"
},
"name": "list_events"
},
{
"description": "The connected tools: status, settings, last sync (found, added, opted out), and their list. No credentials.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_integrations"
},
{
"description": "Your short-link domains and their status (pending_dns, dns_verified, active). Optional: a message sent with shorten_links: true uses the active one, else links.jointextkit.com.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_link_domains"
},
{
"description": "Page through a list's contacts, most recently added first.",
"inputSchema": {
"properties": {
"cursor": {
"type": "string"
},
"id": {
"description": "List id",
"type": "string"
},
"limit": {
"default": 25,
"maximum": 100,
"minimum": 1,
"type": "integer"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "list_list_contacts"
},
{
"description": "List contact lists with their contact counts.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_lists"
},
{
"description": "List your messages, newest first. Filter by number, direction, status, failure reason, date, batch schedule or customer.",
"inputSchema": {
"properties": {
"blocked_reason": {
"description": "Blocked messages with this reason. Implies status=blocked.",
"enum": [
"account_closed",
"account_suspended",
"account_paused",
"opted_out",
"destination_not_allowed",
"voip_number",
"toll_free_destination",
"sender_not_registered",
"campaign_mismatch",
"rate_limited",
"recipient_not_verified",
"quiet_hours",
"consent_required",
"reconfirmation_pending",
"reconfirmation_expired",
"campaign_paused",
"sender_rotation",
"content_blocked",
"screen_unavailable",
"held_for_review",
"review_rejected",
"review_expired",
"quota_exceeded",
"spend_limit_reached",
"insufficient_credits",
"billing_required",
"topic_unsubscribed"
],
"type": "string"
},
"created_after": {
"description": "Inclusive. ISO timestamp or epoch ms.",
"type": "string"
},
"created_before": {
"description": "Exclusive. ISO timestamp or epoch ms.",
"type": "string"
},
"cursor": {
"description": "next_cursor from the previous page",
"type": "string"
},
"customer_id": {
"description": "Filter to one customer's messages",
"type": "string"
},
"direction": {
"enum": [
"outbound",
"inbound"
],
"type": "string"
},
"failure_code": {
"description": "Filter to messages that failed for this reason (the `failure.code` on a message)",
"enum": [
"carrier_filtered",
"unreachable",
"invalid_number",
"opted_out",
"campaign_mismatch",
"content_blocked",
"screen_unavailable",
"rate_limited",
"landline",
"carrier_rejected",
"spend_limit_reached",
"insufficient_credits",
"billing_required",
"sender_not_registered",
"quiet_hours",
"consent_required",
"reconfirmation_pending",
"reconfirmation_expired",
"held_for_review",
"review_rejected",
"review_expired",
"campaign_paused",
"sender_rotation",
"recipient_not_verified",
"quota_exceeded",
"destination_not_allowed",
"voip_number",
"toll_free_destination",
"toll_free_unverified",
"account_closed",
"account_suspended",
"account_paused",
"topic_unsubscribed",
"unknown"
],
"type": "string"
},
"from": {
"description": "Exact sending number (E.164)",
"type": "string"
},
"limit": {
"description": "Max results (default 25, max 100)",
"type": "number"
},
"number": {
"description": "Filter to messages to or from this number",
"type": "string"
},
"schedule_id": {
"description": "Filter to the occurrences of one recurring schedule (sch_...)",
"type": "string"
},
"status": {
"enum": [
"queued",
"sent",
"delivered",
"failed",
"blocked",
"received"
],
"type": "string"
},
"tag": {
"description": "Filter to messages sent with this tag",
"type": "string"
},
"to": {
"description": "Exact destination number (E.164)",
"type": "string"
}
},
"type": "object"
},
"name": "list_messages"
},
{
"description": "List sender pools.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_number_pools"
},
{
"description": "Open short-code and toll-free requests.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_number_requests"
},
{
"description": "List the phone numbers on your account.",
"inputSchema": {
"properties": {
"customer_id": {
"description": "Only this customer's numbers",
"type": "string"
},
"mode": {
"enum": [
"test",
"live"
],
"type": "string"
},
"pool": {
"description": "Pool id",
"type": "string"
},
"q": {
"description": "Matches digits of the number or its label",
"type": "string"
},
"tag": {
"type": "string"
}
},
"type": "object"
},
"name": "list_numbers"
},
{
"description": "List opted-out numbers (the suppression list).",
"inputSchema": {
"properties": {
"cursor": {
"description": "next_cursor from the previous page",
"type": "string"
},
"limit": {
"description": "Max results (default 25, max 100)",
"type": "number"
}
},
"type": "object"
},
"name": "list_opt_outs"
},
{
"description": "The filed copies of a 10DLC registration, newest first.",
"inputSchema": {
"properties": {
"id": {
"description": "Registration id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "list_registration_submissions"
},
{
"description": "List 10DLC brand and campaign registrations and their status. Marketing from a local number needs an approved one.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_registrations"
},
{
"description": "List single messages scheduled for later and not yet sent.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_scheduled_messages"
},
{
"description": "List recurring schedules.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_schedules"
},
{
"description": "List saved segments.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_segments"
},
{
"description": "List message templates.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_templates"
},
{
"description": "List toll-free verifications and their status (draft, in_review with our team, submitted to the carriers, verified, rejected). A toll-free number texts the public only once verified.",
"inputSchema": {
"properties": {
"cursor": {
"description": "next_cursor from the previous page",
"type": "string"
},
"limit": {
"default": 25,
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"status": {
"enum": [
"draft",
"in_review",
"submitted",
"verified",
"rejected"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_toll_free_verifications"
},
{
"description": "List subscription topics.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_topics"
},
{
"description": "Delivery attempts to your webhook endpoints, with response status codes.",
"inputSchema": {
"properties": {
"cursor": {
"description": "next_cursor from the previous page",
"type": "string"
},
"endpoint_id": {
"description": "One endpoint (we_...), or status_callback for the attempts to send messages' own status callbacks.",
"type": "string"
},
"event_id": {
"description": "Every attempt for one event",
"type": "string"
},
"limit": {
"description": "Max results (default 25, max 100)",
"type": "number"
}
},
"type": "object"
},
"name": "list_webhook_deliveries"
},
{
"description": "List webhook endpoints.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_webhooks"
},
{
"description": "Look up line type (mobile, landline, VoIP) and carrier for any US/Canada number.",
"inputSchema": {
"properties": {
"phone": {
"description": "E.164 number",
"type": "string"
}
},
"required": [
"phone"
],
"type": "object"
},
"name": "lookup_phone"
},
{
"description": "Pause an automation: no new runs start, and runs in progress wait where they are until it is activated again.",
"inputSchema": {
"properties": {
"id": {
"description": "Automation id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "pause_automation"
},
{
"description": "Pause a sending or scheduled batch.",
"inputSchema": {
"properties": {
"id": {
"description": "Batch id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "pause_batch"
},
{
"description": "Every input a send needs, as questions to ask the person, with this account's options for each. kind automation: the event that starts it (tracked events with their properties, and the Mixpanel events mapped to them), filters, how long after the event to text, the event that ends it, follow-ups, repeats, who gets it, the message, link, sender and topic. kind broadcast: audience, who to leave out, message, when, sender, topic, follow-up. Also who never gets the text (exclusions) and what is missing (gaps). Changes nothing.",
"inputSchema": {
"properties": {
"kind": {
"default": "automation",
"description": "automation (texts started by an event) or broadcast (one send to an audience).",
"enum": [
"automation",
"broadcast"
],
"type": "string"
}
},
"type": "object"
},
"name": "plan_campaign"
},
{
"description": "Find out where an audience is and the ways to bring it in. Without source: questions to ask the person (where their people are, which group, what they can sign in to, whether consent was recorded, once or kept in sync) and the kinds of source known. With source (their words, e.g. \"Mixpanel\", \"Shopify\", \"our Postgres users table\", \"a Google Sheet\"): the ways in, best first, each with steps and a console link: an integration already syncing it, another connected tool that can read it, a 6-hourly sync connected with their key here or in the console, a push to an ingest URL, a script with a key from their environment, an export, or a CSV upload. Changes nothing.",
"inputSchema": {
"properties": {
"source": {
"description": "Where the people are, in your words. Omit to get the questions first.",
"type": "string"
}
},
"type": "object"
},
"name": "plan_import"
},
{
"description": "The questions behind anything a person does here, with this account's options for each: send a text, buy or release a number, register for 10DLC, verify a toll-free number, request a short code, verification codes, a recurring text, a segment, template, list, topic, connecting a tool, a webhook, an API key, a link domain, a spend limit, a number pool, importing opt-outs, automations, broadcasts. task: a key or the person's words (\"buy a number\"); omit it for the list. Each question names the fields it fills; inputs lists every field the API takes; rules, gaps, and person_submits when the person files it in the console. Changes nothing.",
"inputSchema": {
"properties": {
"task": {
"description": "A task key (buy_number, register_10dlc, ...) or the person's own words (\"buy a number\"). Omit to list the tasks.",
"type": "string"
}
},
"type": "object"
},
"name": "plan_task"
},
{
"description": "See an automation's texts exactly as they would go out, without sending: works on drafts. Pass sample event properties (e.g. {\"amount\": 9.99}) and optionally `to` for a contact's merge fields. Returns each send_sms step's final text (brand and opt-out wording added as we would), segments, encoding, estimated cost, and merge fields that would come out empty.",
"inputSchema": {
"properties": {
"id": {
"description": "Automation id",
"type": "string"
},
"properties": {
"additionalProperties": true,
"description": "Sample event properties for merge fields, e.g. {\"plan\": \"pro\"}",
"type": "object"
},
"to": {
"description": "E.164. Fills contact merge fields and reads what this person has already been shown",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "preview_automation"
},
{
"description": "Count the contacts a segment matches right now and how many a broadcast would reach (opted-out contacts removed, and with topic_id those unsubscribed from it). `notes` says when an event rule names an event never tracked.",
"inputSchema": {
"properties": {
"id": {
"description": "Segment id",
"type": "string"
},
"topic_id": {
"description": "Count only contacts subscribed to this topic",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "preview_segment"
},
{
"description": "Buy a phone number for your account (free sandbox numbers with test keys). Live numbers are billed monthly.",
"inputSchema": {
"properties": {
"customer_id": {
"description": "Optional: assign the number to one of your customers",
"type": "string"
},
"idempotency_key": {
"description": "Optional. Retries are already safe: the same call with the same inputs within 10 minutes is done once and answers with the first result. Pass your own key to dedupe across a longer gap, or a new one to repeat an identical call on purpose.",
"maxLength": 200,
"type": "string"
},
"phone_number": {
"type": "string"
},
"registration_id": {
"description": "Optional (live numbers): the registration this number should send for. Without it the number follows your account's registration.",
"type": "string"
}
},
"required": [
"phone_number"
],
"type": "object"
},
"name": "purchase_number"
},
{
"description": "Count a cohort without saving anything (nothing appears in the console): run up to 10 segment rules now and get the counts (matched, opted out, eligible to text) and the first contacts. Examples: replied in the last 7 days (last_reply_at after 7d); got a batch and did not reply (batch sent, and batch replied with is_not); started checkout but never purchased (event exists, event not_exists); VIPs not texted in 30 days. Same rule fields as a saved segment. Everyone eligible to text: one rule, status is subscribed.",
"inputSchema": {
"properties": {
"limit": {
"default": 25,
"description": "How many matching contacts to return",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"match": {
"default": "all",
"enum": [
"all",
"any"
],
"type": "string"
},
"rules": {
"items": {
"properties": {
"field": {
"description": "Attributes: tag, the name and profile fields, source, field (a custom field), import, status (opt-out), topic, list (in a static list), created_at. Behaviour: last_message_at (last text either way), last_reply_at (last text from them), batch (what happened to them in one batch), event (a tracked event; the newest 20,000 events are searched).",
"enum": [
"tag",
"first_name",
"last_name",
"name",
"email",
"company",
"state",
"source",
"field",
"import",
"status",
"topic",
"created_at",
"last_message_at",
"last_reply_at",
"batch",
"event",
"list"
],
"type": "string"
},
"key": {
"description": "The custom field name (field), topic id (topic), batch id (batch), or event name (event)",
"type": "string"
},
"op": {
"description": "Text fields take is / is_not / contains / not_contains / exists / not_exists; tag takes is / is_not / exists / not_exists; status, topic, import, batch and list take is / is_not; created_at takes before / after; last_message_at, last_reply_at and event take after (at or after the time), before (it happened, and the last time was before it), exists (ever) and not_exists (never). Comparisons ignore case.",
"enum": [
"is",
"is_not",
"contains",
"not_contains",
"exists",
"not_exists",
"before",
"after"
],
"type": "string"
},
"value": {
"description": "status: subscribed or opted_out. topic: subscribed or unsubscribed. import: an import id. list: a list id (lst_...). batch: included, sent, failed, skipped or replied (sent, then texted the batch's number after it was created). Times (created_at, last_message_at, last_reply_at, event): an ISO date, or a window back from now such as 7d or 24h, read each time the segment is used.",
"type": "string"
}
},
"required": [
"field"
],
"type": "object"
},
"maxItems": 10,
"type": "array"
},
"topic_id": {
"description": "Topic id or name: eligible also removes contacts unsubscribed from it",
"type": "string"
}
},
"type": "object"
},
"name": "query_audience"
},
{
"description": "Which text should we send? Ranked SMS copy for a goal (abandoned_cart, welcome, winback, failed_payment, trial, promo, ... or any) by expected revenue per message, each with its evidence: the factors that moved its score, the closest published SMS-only case studies with source links, and how much comes from this account's own sends (clicks, STOPs, revenue from tracked events). Pass your own drafts in `candidates` to score them against the generated ones. Only uses the offer, code and deadline you give it. Sends and saves nothing.",
"inputSchema": {
"properties": {
"audience": {
"description": "Who gets it, in words, e.g. \"opened the paywall and left\"",
"type": "string"
},
"brand": {
"description": "Business name as customers know it",
"maxLength": 40,
"type": "string"
},
"candidates": {
"description": "Your own drafts to score: a JSON array of up to 10 strings",
"type": "string"
},
"code": {
"description": "Optional promo code",
"type": "string"
},
"company_type": {
"description": "Kind of business",
"enum": [
"ecommerce",
"subscription_ecommerce",
"subscription_app",
"consumer_app",
"restaurant",
"hospitality",
"retail",
"marketplace",
"fintech",
"services"
],
"type": "string"
},
"deadline": {
"description": "Optional, e.g. \"tonight\"",
"type": "string"
},
"first_message": {
"description": "The first text these people get from the number: the brand and opt-out line are added and counted",
"type": "boolean"
},
"first_name": {
"description": "Your contacts have first names, so candidates may use {{first_name}}",
"type": "boolean"
},
"goal": {
"default": "any",
"description": "The message type to write, or `any` to compare the types that fit `audience`",
"enum": [
"any",
"abandoned_cart",
"abandoned_browse",
"welcome",
"winback",
"failed_payment",
"trial",
"promo",
"re_engagement",
"post_purchase",
"back_in_stock",
"quiz",
"launch",
"transactional",
"mixed"
],
"type": "string"
},
"industry": {
"description": "The sender's industry",
"enum": [
"apparel",
"home_goods",
"food_beverage",
"restaurant",
"beauty",
"health_wellness",
"cannabis",
"hospitality",
"consumer_app",
"fintech",
"fitness",
"pets",
"arts_crafts",
"jewelry_accessories",
"sporting_goods",
"electronics",
"services",
"other"
],
"type": "string"
},
"limit": {
"default": 5,
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"link": {
"description": "URL or merge field; default {{link}}",
"type": "string"
},
"offer": {
"description": "Optional, e.g. \"50% off your first month\". Without one no candidate has an offer",
"type": "string"
},
"product": {
"description": "What is being sold, as the customer would say it, e.g. \"your second number\"",
"maxLength": 60,
"type": "string"
},
"use_history": {
"default": true,
"description": "false ranks on the case studies only",
"type": "boolean"
}
},
"required": [
"industry",
"company_type",
"brand",
"product"
],
"type": "object"
},
"name": "recommend_message"
},
{
"description": "Empty a finished message's text and media everywhere it is kept, keeping its status, price and timeline (redacted_at is set). Cannot be undone.",
"inputSchema": {
"properties": {
"id": {
"description": "Message id (msg_...)",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "redact_message"
},
{
"description": "Release a number you own. It cannot be got back.",
"inputSchema": {
"properties": {
"phone_number": {
"description": "E.164 number you own",
"type": "string"
}
},
"required": [
"phone_number"
],
"type": "object"
},
"name": "release_number"
},
{
"description": "Remove contacts from a list (they stay contacts).",
"inputSchema": {
"properties": {
"contact_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"id": {
"description": "List id",
"type": "string"
},
"phone_numbers": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "remove_from_list"
},
{
"description": "Send an event again to one webhook endpoint (after fixing the receiver).",
"inputSchema": {
"properties": {
"endpoint_id": {
"type": "string"
},
"id": {
"description": "Event id",
"type": "string"
}
},
"required": [
"id",
"endpoint_id"
],
"type": "object"
},
"name": "replay_event"
},
{
"description": "Re-send every event that failed to reach a webhook endpoint in a window (default the last 24 hours, up to 7 days), after fixing the receiver.",
"inputSchema": {
"properties": {
"id": {
"description": "Webhook endpoint id",
"type": "string"
},
"since": {
"description": "ISO date or epoch milliseconds. Default: 24 hours before `until`.",
"format": "date-time",
"type": "string"
},
"until": {
"description": "ISO date or epoch milliseconds. Default: now.",
"format": "date-time",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "replay_failed_webhooks"
},
{
"description": "Ask our team for a short code (or a toll-free number they set up). Provisions nothing by itself; carriers take 8-12 weeks to approve a short code.",
"inputSchema": {
"properties": {
"business_name": {
"maxLength": 120,
"type": "string"
},
"monthly_volume": {
"enum": [
"under_1k",
"1k_10k",
"10k_100k",
"over_100k"
],
"type": "string"
},
"type": {
"enum": [
"short_code",
"toll_free"
],
"type": "string"
},
"use_case": {
"description": "What you will send, in a sentence or two.",
"maxLength": 500,
"minLength": 10,
"type": "string"
}
},
"required": [
"type",
"business_name",
"monthly_volume",
"use_case"
],
"type": "object"
},
"name": "request_short_code"
},
{
"description": "Resume a paused batch.",
"inputSchema": {
"properties": {
"id": {
"description": "Batch id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "resume_batch"
},
{
"description": "Retry a batch's failed recipients.",
"inputSchema": {
"properties": {
"id": {
"description": "Batch id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "retry_batch"
},
{
"description": "Revoke an API key of this mode. Immediate and permanent: anything using it stops working.",
"inputSchema": {
"properties": {
"id": {
"description": "API key id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "revoke_api_key"
},
{
"description": "Replace a webhook endpoint's signing secret (returned once). expire_previous_in keeps the old one signing for that many seconds so the receiver can switch without dropping events.",
"inputSchema": {
"properties": {
"expire_previous_in": {
"default": 0,
"description": "Seconds the old secret keeps signing alongside the new one.",
"maximum": 604800,
"minimum": 0,
"type": "integer"
},
"id": {
"description": "Webhook endpoint id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "rotate_webhook_secret"
},
{
"description": "Search purchasable numbers by area code (default 415).",
"inputSchema": {
"properties": {
"area_code": {
"type": "string"
}
},
"type": "object"
},
"name": "search_available_numbers"
},
{
"description": "Send one message to many people (a broadcast or campaign): pick recipients by segment_id, tags, contact_ids, or an explicit recipients list. Opted-out numbers, numbers without marketing consent, and people unsubscribed from topic_id are removed before sending. dry_run: true sends nothing and returns the count, cost, rejected rows and consent.no_opt_in (recipients the send will skip for having no opt-in). scheduled_at sends later (up to 30 days). With a live key it texts real people.",
"inputSchema": {
"properties": {
"body": {
"maxLength": 1600,
"type": "string"
},
"category": {
"description": "Optional. It can make the batch stricter (`marketing`), never looser: the sending number's registration and the wording decide ([which messages are marketing](/docs/compliance-checks#which-messages-are-marketing)). From a number with no registration, a batch is marketing.",
"enum": [
"marketing",
"transactional",
"otp"
],
"type": "string"
},
"check_line_types": {
"description": "Reject landlines (first 500 unique numbers are checked).",
"type": "boolean"
},
"contact_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"dry_run": {
"description": "Validate only: returns a BatchValidation and sends nothing.",
"type": "boolean"
},
"from": {
"description": "One of your numbers. Optional while the key's mode has one number.",
"type": "string"
},
"list_id": {
"description": "Send to the contacts in this list, as it is when the batch is created (instead of recipients).",
"type": "string"
},
"name": {
"maxLength": 80,
"type": "string"
},
"quiet_hours": {
"description": "Optional. What to do with a message in the recipient's quiet hours: `block` refuses it (403 quiet_hours), `defer` holds it until their next 8:00am. Omitted: each recipient in quiet hours is held until their 8:00am.",
"enum": [
"block",
"defer"
],
"type": "string"
},
"recipients": {
"items": {
"properties": {
"to": {
"type": "string"
},
"variables": {
"additionalProperties": {
"type": "string"
},
"type": "object"
}
},
"required": [
"to"
],
"type": "object"
},
"maxItems": 10000,
"type": "array"
},
"scheduled_at": {
"description": "Future ISO timestamp or epoch ms, up to 30 days out.",
"type": "string"
},
"segment_id": {
"description": "Send to the contacts in this saved segment, evaluated when the batch is created (instead of recipients).",
"type": "string"
},
"tags": {
"description": "Send to contacts carrying any of these tags (instead of recipients).",
"items": {
"type": "string"
},
"type": "array"
},
"topic_id": {
"description": "Subscription topic. Recipients unsubscribed from it are removed at validation (`topic_unsubscribed`) and skipped at send time, like opt-outs. Omit to apply opt-outs only.",
"type": "string"
}
},
"required": [
"body"
],
"type": "object"
},
"name": "send_batch"
},
{
"description": "Send one SMS from one of your numbers. Set category \"marketing\" for promotions (the opt-in check applies) and scheduled_at to send later. Quiet hours apply to every message: outside 8am-9pm (8pm in Florida, Maryland and Oklahoma) in the recipient's local time a marketing message is refused and anything else is held until 8am, except one-time codes and replies within 4 hours of their text. In sandbox (test keys), delivery is simulated: +15005550006 delivers, +15005550002 fails, +15005550007 is filtered as spam, +15005550013 delivers after a delay, +15005550016 has no opt-in (see /docs/sandbox).",
"inputSchema": {
"properties": {
"body": {
"maxLength": 1600,
"type": "string"
},
"category": {
"description": "Optional. It can make a message stricter (`marketing`), never looser: what a message is comes from the sending number's registration and its wording ([which messages are marketing](/docs/compliance-checks#which-messages-are-marketing)). A message outside its registration's use case is refused with 403 campaign_mismatch.",
"enum": [
"marketing",
"transactional",
"otp"
],
"type": "string"
},
"consent": {
"description": "Optional. How the recipient agreed to your messages. A recurring non-marketing message from a number linked to a registration needs an opt-in on file for that registration; when none is, this records it and the message is sent. Never counts for marketing (use POST /v1/consent with proof). Not with scheduled_at.",
"properties": {
"collected_at": {
"description": "When they agreed: ISO timestamp or epoch ms, not in the future.",
"type": "string"
},
"page_url": {
"description": "Required for web_form: the page the form was on.",
"format": "uri",
"type": "string"
},
"source": {
"enum": [
"web_form",
"keyword",
"paper",
"checkout",
"verbal"
],
"type": "string"
}
},
"required": [
"source",
"collected_at"
],
"type": "object"
},
"customer_id": {
"description": "Optional. Attribute to one of your customers. Defaults to the customer the from-number is assigned to; a number assigned to another customer is rejected (400).",
"type": "string"
},
"from": {
"description": "One of your numbers, or a sender pool id (pool_...): TextKit picks a pool member, the same one for each recipient every time. Optional when the account has exactly one number for the key's mode.",
"type": "string"
},
"idempotency_key": {
"description": "Optional. Retries are already safe: the same call with the same inputs within 10 minutes is done once and answers with the first result. Pass your own key to dedupe across a longer gap, or a new one to repeat an identical call on purpose.",
"maxLength": 200,
"type": "string"
},
"media": {
"description": "Reserved for MMS; currently returns 400 mms_not_enabled.",
"items": {
"format": "uri",
"type": "string"
},
"type": "array"
},
"quiet_hours": {
"description": "Optional. What to do with a message in the recipient's quiet hours: `block` refuses it (403 quiet_hours), `defer` holds it until their next 8:00am. Omitted: the account default (a single marketing send is refused; every other message is held). One-time codes are never held.",
"enum": [
"block",
"defer"
],
"type": "string"
},
"scheduled_at": {
"description": "Optional. Future ISO timestamp (or epoch ms), up to 30 days out. The message is queued and the response is a scheduled_message object instead of a message. A marketing message scheduled into the recipient's quiet hours is refused now (403 quiet_hours) or, with quiet_hours defer, moved to their next 8:00am; any other message is moved.",
"type": "string"
},
"shorten_links": {
"description": "Optional. Rewrite every http(s) link in `body` to a short link with clicks tracked (`links` on the message, `message.link_clicked` events): on links.jointextkit.com, or on your own link domain when you have an active one (POST /link-domains). The links are checked as you wrote them; segments are counted on the shortened text. Works with scheduled_at.",
"type": "boolean"
},
"status_callback": {
"description": "Optional. Also send this message's status events (message.sent, message.delivered, message.failed, message.blocked) to this https URL, signed with your callback secret (POST /v1/webhooks/callback_secret; 400 callback_secret_required until it exists). Logged and retried like a webhook endpoint, under endpoint `status_callback`. Immediate sends only.",
"format": "uri",
"type": "string"
},
"tags": {
"description": "Optional. Your own labels, up to 10 (letters, digits, space _ . : -; up to 32 characters each; lowercased), for example a campaign or a flow. Stored on the message, sent on its webhook events, and reported by GET /v1/deliverability?group_by=tag. Filter with GET /v1/messages?tag=.",
"items": {
"maxLength": 32,
"type": "string"
},
"maxItems": 10,
"type": "array"
},
"to": {
"type": "string"
}
},
"required": [
"to",
"body"
],
"type": "object"
},
"name": "send_message"
},
{
"description": "Send a one-time verification code (OTP) to a phone number by text, or to an email address with channel \"email\". TextKit generates the code, handles expiry (10 min) and attempt limits (5), and blocks SMS-pumping and email-bombing abuse.",
"inputSchema": {
"properties": {
"app_name": {
"description": "Your product name, shown in the message",
"maxLength": 24,
"type": "string"
},
"channel": {
"default": "sms",
"description": "How the code goes out. `sms` needs `phone`; `email` needs `email`.",
"enum": [
"sms",
"email"
],
"type": "string"
},
"customer_id": {
"description": "Optional: attribute the verification to one of your customers",
"type": "string"
},
"email": {
"description": "The address to email the code to (channel `email`). Disposable addresses are refused.",
"type": "string"
},
"from": {
"description": "Optional, channel `sms` only: send from a number you own instead of the TextKit pool",
"type": "string"
},
"idempotency_key": {
"description": "Optional. Retries are already safe: the same call with the same inputs within 10 minutes is done once and answers with the first result. Pass your own key to dedupe across a longer gap, or a new one to repeat an identical call on purpose.",
"maxLength": 200,
"type": "string"
},
"phone": {
"description": "The number to text the code to (channel `sms`). `to` works too.",
"type": "string"
},
"user_ip": {
"description": "Optional. Your end user's IP address, as your server saw it. With it, one person requesting codes for many numbers or addresses is limited (20 an hour per IP on your account, texts and emails together); without it there is no per-IP limit, since requests come from your server.",
"type": "string"
}
},
"type": "object"
},
"name": "send_verification"
},
{
"description": "Record an opt-in or opt-out from your own system (CRM, checkout, a form). An opt-in for a marketing registration needs proof (source, when, the page).",
"inputSchema": {
"properties": {
"campaign_id": {
"description": "Only with opted_in: the registration the person opted in to. A marketing send from a number linked to that registration looks for this record. Proof is required when its use case is marketing or mixed (400 otherwise). An opt-out is always account-wide.",
"type": "string"
},
"note": {
"maxLength": 200,
"type": "string"
},
"phone": {
"description": "E.164 number",
"type": "string"
},
"proof": {
"description": "Opt-in evidence (Messaging Policy 1.4). Accepted only with status opted_in.",
"properties": {
"campaign_id": {
"type": "string"
},
"collected_at": {
"description": "When the person consented; defaults to now",
"format": "date-time",
"type": "string"
},
"disclosure": {
"description": "Exact disclosure wording shown",
"maxLength": 2000,
"type": "string"
},
"ip": {
"type": "string"
},
"message_id": {
"description": "The inbound message that was the opt-in. Required for keyword opt-ins recorded for a marketing registration",
"type": "string"
},
"page_url": {
"description": "Required for web_form",
"format": "uri",
"type": "string"
},
"registration_id": {
"type": "string"
},
"source": {
"enum": [
"web_form",
"keyword",
"paper",
"checkout",
"verbal"
],
"type": "string"
},
"user_agent": {
"maxLength": 500,
"type": "string"
}
},
"required": [
"source"
],
"type": "object"
},
"status": {
"enum": [
"opted_out",
"opted_in"
],
"type": "string"
}
},
"required": [
"phone",
"status"
],
"type": "object"
},
"name": "set_consent"
},
{
"description": "Subscribe a contact to a topic, or unsubscribe them (e.g. \"promotions\" vs \"order updates\").",
"inputSchema": {
"properties": {
"id": {
"description": "Contact id",
"type": "string"
},
"source": {
"description": "Where the change came from, e.g. \"preference_page\". Default \"api\".",
"type": "string"
},
"subscribed": {
"type": "boolean"
},
"topic": {
"description": "Topic id (see list_topics)",
"type": "string"
}
},
"required": [
"id",
"topic",
"subscribed"
],
"type": "object"
},
"name": "set_contact_topic"
},
{
"description": "Set or remove the monthly spend cap and its alert thresholds. Live sends over the cap are refused.",
"inputSchema": {
"properties": {
"alert_thresholds": {
"items": {
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"maxItems": 5,
"type": "array"
},
"monthly_limit_usd": {
"description": "null removes the cap",
"maximum": 1000000,
"minimum": 1,
"nullable": true,
"type": "number"
}
},
"type": "object"
},
"name": "set_spend_limit"
},
{
"description": "Sandbox only: simulate an inbound SMS to one of your test numbers (emits message.received; STOP, START and HELP act as for real).",
"inputSchema": {
"properties": {
"body": {
"type": "string"
},
"from": {
"type": "string"
},
"to": {
"description": "One of your sandbox numbers (never a live number). Optional while the account has one sandbox number.",
"type": "string"
}
},
"required": [
"from",
"body"
],
"type": "object"
},
"name": "simulate_inbound"
},
{
"description": "Sync a connected tool now (up to 6 times an hour) and get what changed.",
"inputSchema": {
"properties": {
"id": {
"description": "Integration id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "sync_integration"
},
{
"description": "Text an automation's messages to your own verified phone or a verified recipient now, skipping waits and conditions, without activating it (drafts work). Pass sample event properties; `steps` sends only those step ids. No run starts and stats do not change. Texts from a live number are real and billed.",
"inputSchema": {
"properties": {
"from": {
"description": "Optional. Send this test from another of your numbers in the same mode (the automation is not changed), e.g. a verified toll-free while its own number is in review.",
"type": "string"
},
"id": {
"description": "Automation id",
"type": "string"
},
"idempotency_key": {
"description": "Optional. Retries are already safe: the same call with the same inputs within 10 minutes is done once and answers with the first result. Pass your own key to dedupe across a longer gap, or a new one to repeat an identical call on purpose.",
"maxLength": 200,
"type": "string"
},
"properties": {
"additionalProperties": true,
"description": "Sample event properties for merge fields",
"type": "object"
},
"steps": {
"description": "Only these send_sms step ids. Default: all of them",
"items": {
"type": "string"
},
"type": "array"
},
"to": {
"description": "E.164: your own verified phone or a verified recipient",
"type": "string"
}
},
"required": [
"id",
"to"
],
"type": "object"
},
"name": "test_automation"
},
{
"description": "Send a signed test.ping to a webhook endpoint and see what it answered.",
"inputSchema": {
"properties": {
"id": {
"description": "Webhook endpoint id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "test_webhook"
},
{
"description": "Record something a customer did (e.g. signed_up, cart_abandoned, trial_ending), by user_id and/or phone. It starts or advances any active automation listening for that event.",
"inputSchema": {
"properties": {
"event": {
"description": "Letters, digits, and _ . : -",
"maxLength": 64,
"type": "string"
},
"idempotency_key": {
"description": "Optional. A unique key for this call: a retry with the same key is recorded once.",
"maxLength": 200,
"type": "string"
},
"phone": {
"type": "string"
},
"properties": {
"description": "Up to 20 scalar values; usable as merge fields and in conditions.",
"type": "object"
},
"user_id": {
"maxLength": 128,
"type": "string"
}
},
"required": [
"event"
],
"type": "object"
},
"name": "track_event"
},
{
"description": "Edit an automation (name, sender, trigger incl. trigger.cooldown_seconds, or steps). `steps` replaces every step; `step` replaces just the one with its id. Pass `if_updated_at` (the updated_at you read): an edit made by someone else since then answers 409 instead of being overwritten.",
"inputSchema": {
"properties": {
"from": {
"description": "One of your numbers. A sandbox number makes it a sandbox flow.",
"nullable": true,
"type": "string"
},
"id": {
"description": "Automation id",
"type": "string"
},
"if_updated_at": {
"description": "The automation's `updated_at` as you read it. If it changed since (another edit), nothing is saved and the answer is 409: read it again and redo the edit on the latest.",
"format": "date-time",
"type": "string"
},
"name": {
"maxLength": 80,
"type": "string"
},
"step": {
"description": "One of: send_sms {body, from?}; wait {seconds}; wait_for_event {event, timeout_seconds, on_received, on_timeout}; condition {check, on_met, on_not_met}; end. Branches are \"continue\", \"end\", or \"goto:<id of a later step>\".",
"properties": {
"body": {
"description": "send_sms. Merge fields: event properties by name, {{first_name}}, {{name}}, {{phone}}, {{field:<custom>}}.",
"maxLength": 1600,
"type": "string"
},
"check": {
"description": "{kind: event_received, event} | {kind: property, property, op, value?} | {kind: contact_field, field, op, value?}. op: eq, neq, contains, gt, lt, exists, not_exists.",
"type": "object"
},
"event": {
"type": "string"
},
"from": {
"description": "send_sms: overrides the flow sender.",
"type": "string"
},
"id": {
"description": "Stable handle for goto branches; assigned when omitted.",
"type": "string"
},
"on_met": {
"type": "string"
},
"on_not_met": {
"type": "string"
},
"on_received": {
"type": "string"
},
"on_timeout": {
"type": "string"
},
"seconds": {
"maximum": 2592000,
"minimum": 60,
"type": "integer"
},
"timeout_seconds": {
"maximum": 2592000,
"minimum": 60,
"type": "integer"
},
"type": {
"enum": [
"send_sms",
"wait",
"wait_for_event",
"condition",
"end"
],
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
},
"steps": {
"description": "Replaces every step.",
"items": {
"description": "One of: send_sms {body, from?}; wait {seconds}; wait_for_event {event, timeout_seconds, on_received, on_timeout}; condition {check, on_met, on_not_met}; end. Branches are \"continue\", \"end\", or \"goto:<id of a later step>\".",
"properties": {
"body": {
"description": "send_sms. Merge fields: event properties by name, {{first_name}}, {{name}}, {{phone}}, {{field:<custom>}}.",
"maxLength": 1600,
"type": "string"
},
"check": {
"description": "{kind: event_received, event} | {kind: property, property, op, value?} | {kind: contact_field, field, op, value?}. op: eq, neq, contains, gt, lt, exists, not_exists.",
"type": "object"
},
"event": {
"type": "string"
},
"from": {
"description": "send_sms: overrides the flow sender.",
"type": "string"
},
"id": {
"description": "Stable handle for goto branches; assigned when omitted.",
"type": "string"
},
"on_met": {
"type": "string"
},
"on_not_met": {
"type": "string"
},
"on_received": {
"type": "string"
},
"on_timeout": {
"type": "string"
},
"seconds": {
"maximum": 2592000,
"minimum": 60,
"type": "integer"
},
"timeout_seconds": {
"maximum": 2592000,
"minimum": 60,
"type": "integer"
},
"type": {
"enum": [
"send_sms",
"wait",
"wait_for_event",
"condition",
"end"
],
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"topic_id": {
"description": "Skip recipients unsubscribed from this topic.",
"nullable": true,
"type": "string"
},
"trigger": {
"properties": {
"cooldown_seconds": {
"description": "Optional. After a run starts for a person, they do not start another for this long (for events that repeat, like a paywall view).",
"maximum": 7776000,
"minimum": 60,
"type": "integer"
},
"event": {
"type": "string"
},
"filters": {
"items": {
"properties": {
"op": {
"type": "string"
},
"property": {
"type": "string"
},
"value": {}
},
"type": "object"
},
"maxItems": 5,
"type": "array"
}
},
"type": "object"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "update_automation"
},
{
"description": "Update a contact. Only the inputs you pass change; tags and fields replace the whole list or map.",
"inputSchema": {
"properties": {
"company": {
"maxLength": 120,
"nullable": true,
"type": "string"
},
"email": {
"maxLength": 254,
"nullable": true,
"type": "string"
},
"fields": {
"additionalProperties": {
"maxLength": 500,
"type": "string"
},
"description": "Up to 20 string values",
"type": "object"
},
"first_name": {
"maxLength": 80,
"nullable": true,
"type": "string"
},
"id": {
"description": "Contact id",
"type": "string"
},
"last_name": {
"maxLength": 80,
"nullable": true,
"type": "string"
},
"name": {
"maxLength": 120,
"nullable": true,
"type": "string"
},
"notes": {
"maxLength": 2000,
"nullable": true,
"type": "string"
},
"phone_number": {
"description": "E.164, US or Canada",
"type": "string"
},
"source": {
"maxLength": 60,
"nullable": true,
"type": "string"
},
"state": {
"maxLength": 40,
"nullable": true,
"type": "string"
},
"tags": {
"items": {
"maxLength": 40,
"type": "string"
},
"maxItems": 20,
"type": "array"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "update_contact"
},
{
"description": "Rename a customer or change its external_id or metadata.",
"inputSchema": {
"properties": {
"external_id": {
"description": "Your id for them; unique per account",
"maxLength": 200,
"nullable": true,
"type": "string"
},
"id": {
"description": "Customer id",
"type": "string"
},
"metadata": {
"additionalProperties": {
"maxLength": 500,
"type": "string"
},
"description": "Up to 50 string values",
"type": "object"
},
"name": {
"maxLength": 200,
"nullable": true,
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "update_customer"
},
{
"description": "Rename, pause or resume (status), or change an integration's settings or credentials (left-out credentials keep the stored ones). eventTriggers (Mixpanel) maps Mixpanel events to TextKit events; changing only those does not re-test credentials or resync.",
"inputSchema": {
"properties": {
"accessToken": {
"type": "string"
},
"apiKey": {
"type": "string"
},
"consentEvent": {
"type": "string"
},
"consentField": {
"type": "string"
},
"eventTriggers": {
"description": "Mixpanel (with a service account): events to turn into TextKit events within about 10 minutes, so automations start, wait and branch on them. Each entry is a TextKit event name and the Mixpanel events that count as it, like { event: \"purchase_completed\", mixpanel_events: [\"Purchase Completed\", \"Web Trial Successful\"] }. Only events from people in the integration's list become events, matched by their Mixpanel id. [] clears them. Changing only these keeps the credentials and the sync schedule as they are (no re-test, no resync). The answer's `warnings` names mapped events that fired 0 times in the last 7 days.",
"items": {
"properties": {
"event": {
"type": "string"
},
"mixpanel_events": {
"items": {
"type": "string"
},
"maxItems": 10,
"type": "array"
}
},
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"id": {
"description": "Integration id",
"type": "string"
},
"name": {
"type": "string"
},
"phoneEvent": {
"type": "string"
},
"phoneEventProperty": {
"type": "string"
},
"phoneField": {
"type": "string"
},
"secret": {
"type": "string"
},
"secretKey": {
"type": "string"
},
"sourceId": {
"type": "string"
},
"status": {
"enum": [
"active",
"paused"
],
"type": "string"
},
"username": {
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "update_integration"
},
{
"description": "Rename a list or change its description.",
"inputSchema": {
"properties": {
"description": {
"maxLength": 200,
"nullable": true,
"type": "string"
},
"id": {
"description": "List id",
"type": "string"
},
"name": {
"maxLength": 80,
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "update_list"
},
{
"description": "Rename a sender pool or change its numbers.",
"inputSchema": {
"properties": {
"description": {
"type": "string"
},
"id": {
"description": "Pool id",
"type": "string"
},
"name": {
"type": "string"
},
"routing": {
"default": "sticky",
"description": "How a recipient gets a number. sticky: the same member every time. local: a member in the recipient's area code, else one in their time zone, else any; still the same one each time.",
"enum": [
"sticky",
"local"
],
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "update_number_pool"
},
{
"description": "Pause (active: false) or resume (active: true) a recurring schedule.",
"inputSchema": {
"properties": {
"active": {
"description": "false pauses, true resumes.",
"type": "boolean"
},
"id": {
"description": "Schedule id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "update_schedule"
},
{
"description": "Rename a segment or replace its rules.",
"inputSchema": {
"properties": {
"description": {
"maxLength": 200,
"nullable": true,
"type": "string"
},
"id": {
"description": "Segment id",
"type": "string"
},
"match": {
"default": "all",
"enum": [
"all",
"any"
],
"type": "string"
},
"name": {
"maxLength": 80,
"type": "string"
},
"rules": {
"items": {
"properties": {
"field": {
"description": "Attributes: tag, the name and profile fields, source, field (a custom field), import, status (opt-out), topic, list (in a static list), created_at. Behaviour: last_message_at (last text either way), last_reply_at (last text from them), batch (what happened to them in one batch), event (a tracked event; the newest 20,000 events are searched).",
"enum": [
"tag",
"first_name",
"last_name",
"name",
"email",
"company",
"state",
"source",
"field",
"import",
"status",
"topic",
"created_at",
"last_message_at",
"last_reply_at",
"batch",
"event",
"list"
],
"type": "string"
},
"key": {
"description": "The custom field name (field), topic id (topic), batch id (batch), or event name (event)",
"type": "string"
},
"op": {
"description": "Text fields take is / is_not / contains / not_contains / exists / not_exists; tag takes is / is_not / exists / not_exists; status, topic, import, batch and list take is / is_not; created_at takes before / after; last_message_at, last_reply_at and event take after (at or after the time), before (it happened, and the last time was before it), exists (ever) and not_exists (never). Comparisons ignore case.",
"enum": [
"is",
"is_not",
"contains",
"not_contains",
"exists",
"not_exists",
"before",
"after"
],
"type": "string"
},
"value": {
"description": "status: subscribed or opted_out. topic: subscribed or unsubscribed. import: an import id. list: a list id (lst_...). batch: included, sent, failed, skipped or replied (sent, then texted the batch's number after it was created). Times (created_at, last_message_at, last_reply_at, event): an ISO date, or a window back from now such as 7d or 24h, read each time the segment is used.",
"type": "string"
}
},
"required": [
"field"
],
"type": "object"
},
"maxItems": 10,
"type": "array"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "update_segment"
},
{
"description": "Rename or edit a template.",
"inputSchema": {
"properties": {
"body": {
"maxLength": 1600,
"type": "string"
},
"id": {
"description": "Template id",
"type": "string"
},
"name": {
"maxLength": 60,
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "update_template"
},
{
"description": "Rename or describe a topic.",
"inputSchema": {
"properties": {
"description": {
"maxLength": 200,
"nullable": true,
"type": "string"
},
"id": {
"description": "Topic id",
"type": "string"
},
"name": {
"maxLength": 60,
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "update_topic"
},
{
"description": "Change a webhook endpoint: URL, events, or turn it off (active: false).",
"inputSchema": {
"properties": {
"active": {
"description": "false pauses delivery; pending retries for a paused endpoint are dropped.",
"type": "boolean"
},
"description": {
"maxLength": 120,
"nullable": true,
"type": "string"
},
"events": {
"oneOf": [
{
"enum": [
"*"
],
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
}
]
},
"id": {
"description": "Webhook endpoint id",
"type": "string"
},
"numbers": {
"description": "Replace the number filter; [] or null clears it.",
"items": {
"type": "string"
},
"maxItems": 100,
"nullable": true,
"type": "array"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "update_webhook"
},
{
"description": "Create a contact, or update the existing one with the same phone_number.",
"inputSchema": {
"properties": {
"company": {
"maxLength": 120,
"type": "string"
},
"email": {
"maxLength": 254,
"type": "string"
},
"fields": {
"additionalProperties": {
"maxLength": 500,
"type": "string"
},
"description": "Up to 20 string values (account id, plan, location...), usable in segments and as {{field:key}} merge fields",
"type": "object"
},
"first_name": {
"maxLength": 80,
"type": "string"
},
"last_name": {
"maxLength": 80,
"type": "string"
},
"name": {
"description": "Display name. Defaults to first + last name.",
"maxLength": 120,
"type": "string"
},
"notes": {
"maxLength": 2000,
"type": "string"
},
"opt_in": {
"description": "Import only (POST /v1/contacts/import). Stored as consent evidence; never lifts an opt-out.",
"properties": {
"at": {
"description": "When they opted in: ISO timestamp, date, or epoch ms",
"type": "string"
},
"campaign_id": {
"description": "The registration the opt-in is for. A marketing or mixed registration needs at, a recognised source, and page_url for a web form, or the row is skipped",
"type": "string"
},
"page_url": {
"description": "The page a web-form opt-in was collected on",
"format": "uri",
"type": "string"
},
"source": {
"description": "web_form, keyword, paper, checkout or verbal are stored as proof; anything else is kept as a note",
"type": "string"
},
"status": {
"description": "true = opted in; false = unsubscribed (recorded as an opt-out)",
"type": "boolean"
}
},
"type": "object"
},
"phone_number": {
"description": "E.164, US or Canada",
"type": "string"
},
"source": {
"description": "Where the contact came from. Defaults to \"api\".",
"maxLength": 60,
"type": "string"
},
"state": {
"maxLength": 40,
"type": "string"
},
"tags": {
"items": {
"maxLength": 40,
"type": "string"
},
"maxItems": 20,
"type": "array"
}
},
"required": [
"phone_number"
],
"type": "object"
},
"name": "upsert_contact"
},
{
"description": "Check a link domain's DNS records now. When both are found it is turned on (active) at once.",
"inputSchema": {
"properties": {
"id": {
"description": "Link domain id (ld_...)",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "verify_link_domain"
},
{
"description": "Wait up to 25 seconds for the next events after a cursor (a reply, a delivery receipt), then return them.",
"inputSchema": {
"properties": {
"cursor": {
"description": "The `cursor` of the previous response. Omit on the first call.",
"type": "string"
},
"timeout": {
"default": 20,
"description": "Seconds to hold the request.",
"maximum": 25,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"name": "wait_for_events"
}
]
}What the leaf hashes
{"body":"43044371725adba3d400f76a88a101d3a5e09b16aca6a84c62c08157bcde3a81","id":1053659,"kind":"mcp.tools","method":"probe.mcp/1","observed_us":1793311847315210,"prev":1014410,"subject":"af3c9bd5-b207-4dc1-b10b-34d79fe56a48","subject_kind":"endpoint"}Proof
Fold these into the leaf in order, hashing each sorted pair with keccak256, to reach the root of (242798 rows).
- 0x1fd0968a4b9e8d75398086c18773e3802f3b3e37cce32e61641cd50018bc462d
- 0x9cfd97e9c19fdd6723cb3c6b0b4143eb2d232123d03c081d929c4cfcb0ec24f8
- 0xed677fc6252547a66a49188aaa98c8a87c49217bbce4fe6126f61033deba6aa3
- 0x8e585da23576683289ce2a5bb8df9e6cd886f373594cef9577c54f42604f430f
- 0x7f01730a46b069a252a4ecb743f6dddc14b28c658897dd786ff3ffac1446b2cc
- 0x0ce724484d342387eff633fa3302045d7ebf945c247566aef5fba3f26693500c
- 0xa00e67af63c48394d47b7438eadbdd5d8a4d596fdd8d8a3b66664694243824f7
- 0xea81e6e6fdb7596cf90afdb2c066a1f540c91e16be38b697f7a2ca55e257861d
- 0xaee03836c00015e4cd4dd2646e083637475a9512a6513fd7ecebca3ccfb53bd3
- 0x77f6432f4fb231a415bcdb8a218dbf15c8152ec4e896d305cf77e0147c2a12a9
- 0xbae9ae897c8c37a21639922854cce103414570e0f7f4f54aeee910d6f9dec380
- 0xbf2390181865b3a3903152f9e78bb4ea857b7639e51f736e790ec404c300ceff
- 0x2d6c35a712c459205bbb66125aacf09776ad4f268b7d0b46df94b6c1de844c05
- 0xb18cebb16334d2052fd6b64bc0dc0c2adeb9f63dcffef7910b6a52f2c75203ef
- 0xb4cbfd07748aa7d27896e5517d69e2e77024b97a1cfe1755f9af8471ad993bde
- 0xa0a7723889a4c15b3e0bec353fa8dbcaec6c71cf35bb6c346415ad3e664df6a6
- 0xd76435ead496863d8b0bfab3434f54cd11da3c49d104fc4064b9cb3381567bbd
- 0xd56e61af23709ed9f460471e3c08400c0142ee83e1fd9057e46350d12edf9c07
- Day root
- 0xc050555c6b023f2aefb6536efb9f0760b92c30a0d06c572b7daf63db259ea17c
- Chained
- 0x4cde8bae2042512e1bec11650628f0293556311cc4ea74d99ffddf02b671a7d6
- Published
- On Arc Testnet, block 69753317: 0x9e85c340732f416e431b111fae72f7624870125f7f379af2732eb6c2ba8cf6a1