ZuckerBot › Tool reference › Strategy & campaign build

Duplicate Ad

zuckerbot_duplicate_ad

Duplicate ONE supported ad into an existing ad set in the SAME ad account. Dry-run by default: it returns the exact object plan (1 new creative + 1 new ad) without creating anything; pass execute: true plus an idempotency_key to perform it. The duplicated ad is ALWAYS created PAUSED — activating it is a separate deliberate action. Supported source shapes: static single-image creatives with an accessible image hash, and single pre-uploaded video creatives. Carousel, dynamic/catalogue, existing-post and multi-asset creatives are rejected with the unsupported feature named. A new creative is always built — creative IDs are never reused.

Parameters

Name	Type		Description
`business_id`	string	optional	Optional business ID override for the authenticated API key
`source_ad_id`	string	required	Numeric Meta ad id to duplicate (must be in the connected ad account)
`target_adset_id`	string	required	Numeric Meta ad set id to create the duplicate in (must be an EXISTING ad set in the same ad account)
`name`	string	optional	Override: name for the new ad (default: '<source name> (copy)')
`primary_text`	string	optional	Override: primary text / body copy
`headline`	string	optional	Override: headline
`description`	string	optional	Override: description
`cta`	string	optional	Override: uppercase Meta CTA type, e.g. LEARN_MORE or SIGN_UP
`final_url`	string	optional	Override: destination URL (http/https)
`execute`	boolean	optional	Default false (dry-run). Set true to actually create the PAUSED duplicate — requires idempotency_key
`idempotency_key`	string	optional	Required when execute is true. Generate once per logical operation (UUIDv4 recommended); reuse the identical value only when retrying the identical request

Example call

{
  "tool": "zuckerbot_duplicate_ad",
  "arguments": {
    "source_ad_id": "<source_ad_id>",
    "target_adset_id": "<target_adset_id>"
  }
}

You never invoke this directly — describe what you want in plain English inside Claude, Cursor, ChatGPT or any MCP client with ZuckerBot connected, and the agent selects zuckerbot_duplicate_ad and fills the arguments for you.

Related tools — Strategy & campaign build

Connect ZuckerBot to your AI agent in about two minutes: get started free, browse the full tool reference, or grab the lifetime deal.