replace_ad_creatives
Replace the creative of live ads with library creatives, as drafts.
The tool for “swap these approved creatives in for my most fatigued ads” (or any “replace this ad’s creative”), however many ads: replacements = [{account_id, ad_id, creative_id}], one per live ad (account_id and ad_id from get_creative_insights fatigue.fatiguing actions or list_ads; creative_id an uploaded or generated library image creative, e.g. from list_creative_library(review_status= “approved”) or a table’s media_files creative_id). Each ad is copied as a NEW PAUSED ad into its own ad set / ad group with the new image; the old ad keeps running and keeps its history. Copies are grouped per platform, so each platform is one review and one approval. A replacement that cannot be drafted is reported with its reason; the others are still drafted. The same ad and creative always map to the same draft (asking again never copies twice; “published” means that pair was already replaced). Stores drafts only.
After publishing, nothing has switched yet: the new ads are paused and the old ones still run. Follow switch_over for each account to enable the new ads and pause the replaced ones (one create_ad_edit_plan for both where the platform declares edit drafts), and say so to the person.
Returns {replacements: [{account_id, ad_id, creative_id, review_status, status: drafted|published|refused, plan_id?, reason?}], reviews: [{platform, group_id | plan_id, next}], switch_over: [{platform, account_id, replaced_ad_ids, next}]}. review_status is the creative’s review record; it never blocks publishing.
Parameters#
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
replacements | array | yes | ||
title | string | no | ||
thread_id | string | no |
Generated by generate_mcp_docs from the server tool. Add to this page below this block; the block is rewritten on every run.