Replace Ad Creative (edit ad content)
adsap_replace_ad_creativeDESTRUCTIVE. Edit the CONTENT of an existing Meta ad: primary text, headline, description, CTA, destination link, display link, UTM url_tags, the image/video itself, and Shop (shop: 'on' or 'off'). Meta creatives are immutable, so this builds a NEW creative and repoints the ad: the ad keeps its id but gets a new creative_id and the old creative is orphaned. Editing a live/spending ad can reset its social proof (likes/comments/shares) and restart the learning phase. Text fields are ARRAYS: send the COMPLETE set with your edits applied; entries you don't change are preserved verbatim (primary_texts, headlines, descriptions). To change the same text in several ads, use adsap_replace_ad_text instead: one preview and one confirmation for all of them. Media swaps use creative-library assets only and are like-for-like (image->image, video->video); for multi-image ads (square + vertical) use the media array, one entry per slot. ALWAYS call with dry_run: true first: the preview returns the before/after diff AND the current media slots (use those to build a media swap), then dry_run: false to apply. When the ad's format has no room for a change (for example two primary texts on an ad that holds one), the answer is EDIT_NOT_SUPPORTED and nothing is changed: tell the user, using the message as returned. Everything you do not ask to change stays exactly as it is: enhancements, Shop, the other text variations, the button and the media. Both answers check it. Shop: off means people always go to the website; on means Meta can send people to the business's Facebook or Instagram shop instead, if the business has one. The preview's settings_check.shop is the ad's current Shop setting and settings_check.shop_applies says whether Shop applies to the ad at all (website ads only). Say nothing about the check when it finds nothing. Only when settings_check.unexpected (preview) or after_apply_check.unexpected (apply) is above 0: tell the user which settings would change or changed, using the setting names and values as returned, and before an apply get the user's confirmation again. Entries marked expected: true are Meta bookkeeping (a new id Meta gives a video on every video edit, a retired summary switch Meta no longer accepts): never mention them unless the user asks.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ad_id": "<ad_id>",
"ad_account_id": "<ad_account_id>",
"creative_spec": "<creative_spec>"
},
"name": "adsap_replace_ad_creative"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ad_id | Yes | The Meta AD id to edit (the ad, not the creative). The ad keeps this id; only its creative is replaced. | |
| dry_run | No | true = preview the before->after diff without writing anything. ALWAYS run dry_run: true first. | |
| ad_account_id | Yes | act_<digits>. | |
| creative_spec | Yes | The content fields to change. Text fields are ARRAYS: send the complete set with edits applied; unchanged entries are kept. Media swaps use creative-library assets only (image->image, video->video). At least one field is required. |