edit-meta-creative

Goal

Apply a creative-content change to one or more existing Meta ads without losing learning, frequency caps, ad post engagement, or the ad ID. The same ad_id keeps running with a new creative attached.

The Meta reality this command exists to handle

Meta does not allow in-place edits of creative content (URL, text, headline, image, CTA). The only way to change an existing ad's creative is:

get_ad_creative → modify payload locally → create_ad_creative → replace_ad_creative

Anything else (deleting + recreating the ad) destroys learning, frequency capping, social proof (likes/comments), and breaks any link people have to the ad post. Always use replace_ad_creative — never delete-and-recreate for a creative change.

Inputs to confirm (batch)

1. Account name (substring) — required.
2. Scope — required. One of:
   • Single ad ID(s).
   • All ads in a campaign / ad set (by name or ID).
   • All active ads in the account matching a filter (e.g. status=ACTIVE).
3. What to change — required. Examples:
   • Landing page URL (the most common bulk edit).
   • Primary text / headline / description / link description.
   • Call-to-action button.
   • Display link / deep link.
4. Old → new mapping if it's a find-and-replace (e.g. swap utm_campaign=spring for utm_campaign=summer, or replace oldsite.com with newsite.com).

Workflow

1. Discover ops: meta_ads_select_accounts, meta_ads_list_ads, meta_ads_list_adsets, meta_ads_list_campaigns, meta_ads_get_ad_creative, meta_ads_create_ad_creative, meta_ads_replace_ad_creative.
2. Inspect each with get_operation_inputs.
3. Resolve account via meta_ads_select_accounts (substring).
4. Resolve scope to a list of ad_ids via meta_ads_list_ads with the right filters (campaign, ad set, status). Show the user the ad list and the count before doing anything else.
5. For each ad in scope: a. meta_ads_get_ad_creative(ad_id) → returns the raw creative payload. b. Modify the payload locally based on the requested change. Preserve all fields the user did not ask to change. Common fields to patch:
   • object_story_spec.link_data.link (URL for link/single-image ads)
   • object_story_spec.link_data.message (primary text)
   • object_story_spec.link_data.name (headline)
   • object_story_spec.link_data.description (link description)
   • object_story_spec.link_data.call_to_action.value.link (CTA link)
   • object_story_spec.link_data.call_to_action.type (CTA button type, e.g. LEARN_MORE, SHOP_NOW)
   • For video ads: object_story_spec.video_data.*
   • For carousel: each item under object_story_spec.link_data.child_attachments[] c. meta_ads_create_ad_creative(modified_payload) → returns new creative_id. Only works when the existing media (image_hash / video_id) is reused. If the user is also swapping in fresh media that isn't already in Meta, see "Fresh media" below. d. meta_ads_replace_ad_creative(ad_id, creative_id) → attaches the new creative.
6. Build a diff preview before executing. Show the user a table of every ad with old → new for each changed field. Wait for explicit confirmation. Then run all replaces, batched into a single request_human_approval if approval is required.
7. Confirm: count succeeded, count failed (with reason), list of new creative_ids.