Update campaign
Update, pause, resume, schedule, or complete a campaign.
Authorizations
A workspace API key.
Path Parameters
A campaign id, from GET /v1/campaigns.
1 - 200"cmp_5a72"
Body
Human-readable campaign name. This is the only required field.
1 - 160Internal campaign brief or purpose. Defaults to empty.
4000Existing connected social-account ids selected in the dashboard. Omit when creating only the campaign container.
1001 - 200Platforms this campaign targets. Accepted values are listed below; defaults to an empty list.
50tiktok, instagram, youtube, x, linkedin, threads, reddit, mastodon, facebook, substack, whatsapp, telegram, bluesky, snapchat, medium, quora, nextdoor, rumble, xiaohongshu, pinterest, tumblr, discord, vimeo, devto, hashnode, google_business, lemmy, yelp, yellowpages, bing_places, apple_business manual does not automate; review-first requires approval; fire-and-forget runs without that checkpoint.
manual, review-first, fire-and-forget Lifecycle state. New campaigns default to draft.
draft, scheduled, active, paused, completed ISO 8601 date-time for the planned start. Null means not scheduled.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$"2026-08-15T09:00:00Z"
Existing generation job ids associated with the campaign. Read job ids from generation responses; defaults to empty.
5001 - 200Optional internal marketing playbook id. Most API clients should omit this; null lets Sigmora choose its normal strategy.
1 - 200