Clone live campaign
Clone a live campaign into one or more fresh Koast batches as editable DRAFTS, a full deep-copy of the campaign tree (ad sets, ads, copy, re-imported creatives) with all ad-platform IDs stripped, so each clone is a brand-new launchable draft.
Tool name: clone-live-campaign.
Clone a live campaign into one or more fresh Koast batches as editable DRAFTS, a full deep-copy of the campaign tree (ad sets, ads, copy, re-imported creatives) with all ad-platform IDs stripped, so each clone is a brand-new launchable draft. This is the correct path for "make a new campaign just like this one / keep everything the same / launch this N more times": clone first, then vary copy or settings on the cloned DRAFT ads (no live-edit needed). Because each batch holds AT MOST ONE campaign, N clones create N separate batches, pass count. Pass the campaign id on the ad platform (from listAccountCampaigns), NOT a Koast nodeId. Use this instead of rebuilding from scratch (which drags in stale account defaults) and instead of duplicateNode (which can't duplicate a whole campaign).
When to use
Replicate a live campaign as fresh editable drafts. "New campaign like this one" / "launch this N more times" → clone, then vary on the drafts. N clones = N batches (one campaign per batch). Use the ad-platform campaign id from listAccountCampaigns, not a Koast nodeId.
Access
| Property | Value |
|---|---|
| Required scope | write |
| Publishes | No |
| Read-only | No |
| Destructive | No |
| Idempotent | No |
| Open world | Yes |
Input
| Field | Type | Required | Description |
|---|---|---|---|
providerCampaignId | string | Yes | Campaign id to clone on the ad platform (the raw id from listAccountCampaigns rows). |
count | integer | No | How many cloned batches to create (1 batch per clone, max 20). Default 1. Minimum 1, maximum 20. |
titlePrefix | string | No | Optional title prefix for the cloned batches; a copy index is appended when count > 1. At most 180 characters. |
brandId | integer | No | Optional Koast brand id. Required from a multi-account dashboard chat; otherwise uses the current context. |
Output
| Field | Type | Required | Description |
|---|---|---|---|
clones | object[] | Yes | |
requested | number | Yes |
REST equivalent
POST /v1/brands/{brandId}/launches/clone, Clone live campaign. CLI: koast clone-live-campaign.