Change a campaign
update_campaignDestructive
Change a draft, or a paused campaign's words: any field; rows to add (up to 5,000 a call; reset starts the list again); finish_list once every row is in (duplicates merge, opted-out and other countries' numbers are left out, recent people go first); remove to take people out by tier or number. New words need a new test.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>"
},
"name": "update_campaign"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The campaign's id (cmp_…) | |
| ask | No | The question people last seen over 5 years ago get first; only a YES gets them the text. On by default. | |
| from | No | Who the texts are from, said first, e.g. XYZ Events | |
| lang | No | The text's language code (en, es, fr…): replies are read in it | |
| name | No | Its name, for the user only | |
| rows | No | People to add to a draft's list | |
| sims | No | The SIMs it sends from, as get_campaign lists them | |
| text | No | The text. Blanks: {{first_name}}, {{name}}, {{event}}, {{year}}, with a fallback like {{first_name|there}}. How to stop is added to each person's first text. | |
| hours | No | Sending hours in the recipients' own time; 09:00 to 20:00 every day unless changed, and always kept inside a texted country's own rule | |
| reset | No | With rows: drop the list so far and start again | |
| limits | No | Optional: a slower pace per SIM, in SMS parts. It can't go faster. | |
| remove | No | Take people who weren't texted yet out of the list | |
| mid_line | No | Optional line for people last seen 2 to 5 years ago, e.g. You came to {{event}} in {{year}}. | |
| start_at | No | Optional: not before this (within 60 days) | |
| finish_by | No | Optional: when it should be done; the plan says if it fits | |
| finish_list | No | Finish the list once every row is in | |
| other_countries | No | Also text the list's numbers from other countries (left out by default) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | ||
| added | No | ||
| invalid | No | ||
| campaign | Yes | ||
| examples | No |