AdnovaDocs
Ad Launcher

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, adSets
  • adId — 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). Only adName, adSets, utm are applied; all other fields are ignored.
  • Recreate with edits — preferCreativeId omitted/false (set hasCreativeEdits: true when 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

  • adId replaces creativeDetails — they're mutually exclusive. The existing creative is reused.
  • hasCreativeEdits — true applies your copy edits; omit/false for 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 (creativeDetails is forbidden alongside adId). To run a new creative, launch a fresh ad instead.
  • The adId must belong to the same ad account (adAccountId).