Edit existing ad
Re-launch or modify an already-created Meta ad by id — copy, targeting, or schedule.
An edit-existing launch references an already-created Meta ad by adId and re-launches it with changes to copy, targeting (adsets), or schedule. The original creative is preserved — this flow does not swap the creative file.
When to use this
You want to duplicate an existing ad into new adsets, refresh its copy, or change its schedule — without rebuilding the creative.
Examples by variation
All variations POST /meta/launches and set adId + adName + adSets. The mode is chosen by preferCreativeId (see Two modes below). Full schema: Create a launch.
1. Duplicate as-is into new adsets (preferCreativeId: true)
Relaunches the exact existing creative/post into additional adsets. Only adName, adSets, and utm are applied; everything else is ignored.
{
"adAccountId": "01H8Y4...",
"platform": "meta",
"ads": [
{
"adName": "Spring Hero — more adsets",
"adSets": ["123456789012345", "223456789012345"],
"adId": "120210000000000000",
"preferCreativeId": true,
"utm": "utm_source=facebook&utm_medium=cpc&utm_campaign=spring_expand"
}
]
}2. All editable fields (recreate mode)
Every key accepted in recreate mode (hasCreativeEdits: true), with sample values. Fields outside the editable set are ignored.
{
"adAccountId": "01H8Y4...",
"platform": "meta",
"ads": [
{
"adName": "Spring Hero — full edit",
"adSets": ["123456789012345", "223456789012345"],
"adId": "120210000000000000",
"hasCreativeEdits": true,
"preferCreativeId": false,
"adProfiles": {
"facebook_page_id": "123456789012345",
"instagram_account_id": "987654321098765",
"page_backed_instagram_account_id": null
},
"cta": "LEARN_MORE",
"defaultPrimaryText": "Extended! Spring sale through Sunday.",
"primaryTextVariations": ["Final days of the spring sale", "Last chance — up to 40% off"],
"defaultHeadline": "Final days",
"headlineVariations": ["Ends Sunday", "Up to 40% off"],
"adDescription": "Free shipping on orders over $50.",
"webLink": "https://example.com/spring/lookbook",
"displayLink": "example.com/spring",
"utm": "utm_source=facebook&utm_medium=cpc&utm_campaign=spring_extend",
"leadGenFormId": null,
"productSetId": "678901234567",
"adSchedule": { "startDate": "2026-06-10T00:00:00Z", "endDate": "2026-06-30T23:59:59Z" },
"promoCodeDetails": { "type": "manual", "manualCodes": ["SPRING40", "EARLYBIRD"] },
"aiMediaDisclosure": true
}
]
}Required fields
adName,adSetsadId— the existing Meta ad to edit / relaunch
cta and webLink are not required (the existing creative is reused).
Two modes (preferCreativeId)
- Relaunch as-is —
preferCreativeId: true. Reuses the existing ad's exact creative (its creative/post id). OnlyadName,adSets,utmare applied; all other fields are ignored. - Recreate with edits —
preferCreativeIdomitted/false(sethasCreativeEdits: truewhen changing copy). Adnova builds a new ad reusing the existing creative plus your edits. Editable fields:adName,adSets,adProfiles,defaultPrimaryText(+variations),defaultHeadline(+variations),adDescription,cta,webLink,displayLink,leadGenFormId,productSetId,promoCodeDetails,adSchedule,aiMediaDisclosure.
Precedence: if both preferCreativeId: true and hasCreativeEdits: true are sent, preferCreativeId wins — the ad relaunches as-is and every edit is ignored. To apply edits, set hasCreativeEdits: true and leave preferCreativeId off (or false).
Fields outside the active mode's editable set are accepted but ignored.
Field notes
adIdreplacescreativeDetails— they're mutually exclusive. The existing creative is reused.hasCreativeEdits—trueapplies your copy edits; omit/falsefor a plain duplicate.preferCreativeId— reuse the existing creative id rather than rebuilding the creative object.adSets— the adsets to (re)launch under; this is how you fan an existing ad into new adsets.aiMediaDisclosure— applied only when Adnova builds a new creative (recreate with edits). A creative Meta already has can't be relabelled, so on a plain duplicate that reuses the existing creative the flag has no effect.
Gotchas
- You cannot change the creative file here (
creativeDetailsis forbidden alongsideadId). To run a new creative, launch a fresh ad instead. - The
adIdmust belong to the same ad account (adAccountId).
