Update a campaign
update_campaignUse this when the user wants to change a campaign's settings: its name, start, sending days and time zone, lists and exclusions, tracking, daily limits or link. Send at least one. New lists replace the campaign's lists but enroll nobody in a running campaign. Click tracking cannot be turned off while a step waits for a click. It changes settings only, never what the steps say. Free.
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": {
"campaignId": "<campaignId>"
},
"name": "update_campaign"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | A new name. | |
| ctaLink | No | The link steps insert where they write `{CTA Link}`: an http or https URL, or null or empty for none. | |
| listIds | No | The campaign's lists, replacing the ones it has, 1 to 10. A running campaign does not enroll a new list's people: adding one list to the campaign does that. | |
| timezone | No | The IANA time zone the sending days and hours (9:00 to 17:00) are read in, such as `Europe/Lisbon`: a region, not an abbreviation such as EST. UTC when a campaign is created without one. | |
| emailDays | No | The days messages may go out, by English name with a capital first letter. Monday to Friday when left out. | |
| isDynamic | No | Enrolls people added to the campaign's lists after launch, as they arrive. False when left out. | |
| startDate | No | When sending may start, as an ISO 8601 date-time. Now when left out. | |
| campaignId | Yes | The campaign's id. | |
| excludeLists | No | Up to 10 people lists whose people are never enrolled, matched by person, email address or LinkedIn profile. An id that is not one of your lists excludes nobody. | |
| dailyEmailLimit | No | The most emails the campaign sends a day, 1 to 10,000, or null for no limit. | |
| excludeContacted | No | Skips people your campaigns already wrote to: `none` (the default) skips nobody, `ever` skips everyone written to, and `last_1_month` to `last_1_year` skip those written to in that time. | |
| addUnsubscribeLink | No | Ends every email with a one-click unsubscribe link. True when left out. | |
| excludeCompanyLists | No | Up to 20 company or people lists: nobody who works at one of their companies is enrolled. A list the organization does not have answers `422` `exclude_company_lists_invalid`. | |
| clickTrackingEnabledAt | No | Turns click tracking on from this ISO 8601 date-time, or off with null. Off when left out. A step that waits for a click needs it on. | |
| excludeEngagedContacts | No | Skips people who replied to one of your campaigns. False when left out. | |
| dailyLinkedinMessageLimit | No | The most LinkedIn messages and InMails the campaign sends a day, 1 to 10,000, or null for no limit. | |
| openRateTrackingEnabledAt | No | Turns open tracking on from this ISO 8601 date-time, or off with null. Off when left out. | |
| dailyLinkedinConnectionLimit | No | The most LinkedIn invitations the campaign sends a day, 1 to 10,000, or null for no limit. | |
| sendOnlyToValidatedEmailsEnabledAt | No | From this ISO 8601 date-time, enrolls only people whose email address checked `valid`; null also enrolls catch-all and unchecked addresses. |