Skip to content
AdlyseDocs
Product guideMCP reference
⌘K
Open Adlyse
⌘K
Overview
QuickstartAuthentication
adlyse-insights
adlyse-ads
list_ad_accountsget_platform_supportget_write_operationsget_ad_creation_capabilitiesget_ad_build_specupdate_ad_build_speclist_ad_plansget_ad_plan_publicationget_ad_planimport_ad_to_planimport_live_ad_to_planreplace_ad_creativescreate_ad_plan_variantsadd_ad_plan_variantsupdate_ad_plan_groupgroup_ad_plansget_ad_plan_groupfreeze_ad_plan_grouppublish_ad_plan_groupcreate_ad_plancreate_ad_edit_planupdate_ad_planattach_ad_plan_assetfill_ad_plan_slotsfreeze_ad_planpublish_ad_planresolve_ad_publish_steplist_campaignsget_performancelist_change_eventslist_adsget_ad_performancelist_creative_librarypause_creative_adsupdate_ad_group_statusupdate_ad_statusupdate_campaign_statusupdate_campaign_budgetlist_swipe_filesave_competitor_ad_to_swipe_filesave_creative_to_swipe_fileremix_from_swipe_filestart_creative_jobresize_creativemake_variants_of_winnerget_creative_jobestimate_creative_batchstart_creative_batchbatch_to_plan_groupget_creative_batchsnapshot_catalog_productsgenerate_ad_copylist_ad_copycreate_creative_conceptpropose_creative_conceptsaccept_creative_concept_proposalupdate_creative_conceptlist_creative_conceptslist_personasget_personacreate_personaupdate_personadelete_personasuggest_personasrequest_creative_reviewget_creative_reviewupdate_draft_creative_copydelete_draft_creativescancel_creative_jobsave_url_to_swipe_fileupdate_swipe_file_itemset_swipe_file_favoriteremove_from_swipe_fileget_creative_workget_creative_workspaceopen_creative_workspacesave_creative_revisionselect_creative_revisionwithdraw_creative_reviewchange_creative_workspace_lifecyclemanage_creative_conceptmanage_creative_sizeslist_creative_reviewslist_creative_commentsadd_creative_commentresolve_creative_commentretry_persona_creationresolve_creative_copy_anglebind_creative_workspace_conversationlist_creative_jobsget_creative_performance_detail
adlyse-workflows
adlyse-admin
adlyse-all
  1. Overview
  2. adlyse-ads

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#

NameTypeRequiredDefaultDescription
replacementsarrayyes
titlestringno
thread_idstringno

Generated by generate_mcp_docs from the server tool. Add to this page below this block; the block is rewritten on every run.

Previousimport_live_ad_to_planNextcreate_ad_plan_variants