Duplicate ad

POST 
/ad-publishing/facebook/ads/:adId/duplicate

Duplicate an existing Facebook ad

Request

Version stringrequired

API Version

Available optionsv3

adId stringrequired

Ad identifier

application/json

application/json

Body

Bodyrequired

locationIdstringrequired

Location identifier

Example (auto)

{
  "locationId": "HChooFuiyPpVYzeJ4HMe"
}

application/json

The duplicated ad, as a new draft

application/json

Schema

Schema

idstringrequired

Ad identifier

namestringrequired

Ad name

campaignIdstringrequired

Parent campaign id

adsetIdstringrequired

Parent ad set id

fbAdIdstring

Facebook ad id, set once published

publishingStatusstringrequired
Publishing status. On a published entity this is not the state you asked for but the effective_status Meta reports, mapped back — a pause or resume re-reads it live, so an ad awaiting review comes back IN_REVIEW rather than PAUSED or PUBLISHED. Any effective status this service does not recognise also maps to IN_REVIEW.
Available optionsDRAFTSCHEDULEDPUBLISHINGPUBLISHEDPAUSEDIN_REVIEWWITH_ISSUESREJECTEDARCHIVEDFAILED
fbErrorstringnullable

Publish error from Facebook. null on reads when there is none.

mediaTypestringrequired

Creative format

ctastring

Call-to-action button

multiAdvertiserAdsbooleanrequired

Whether multi-advertiser ads are enabled

primaryTextsobject[]required

Primary text variants. Used by SINGLE image and video ads.

headlinesobject[]required

Headline variants

descriptionsobject[]required

Description variants

primaryTextstring

Single primary text. Carried alongside primaryTexts, mirroring its first entry.

headlinestring

Single headline. Used by carousel ads; mirrors the first headlines entry otherwise.

descriptionstring

Single description

mediaobject[]required

Creative media

destinationFormIdstring

Instant form the ad routes to, when the conversion location is on-ad

destinationLinkstringnullable

Click destination. null when the ad routes to an instant form instead.

unpublishedChangesboolean

Whether the ad has edits not yet published

createdAtstringrequired

Created at

updatedAtstringrequired

Updated at

Example (auto)

{
  "id": "6a323f3f4454921db1498ce1",
  "name": "Ad 1",
  "campaignId": "6a323f3e4454921db1498ccf",
  "adsetId": "6a323f3f4454921db1498cd8",
  "fbAdId": "120250378908850122",
  "publishingStatus": "PUBLISHED",
  "fbError": null,
  "mediaType": "SINGLE",
  "cta": "GET_OFFER",
  "multiAdvertiserAds": true,
  "primaryTexts": [
    {
      "text": "Book a free demo",
      "_id": "6a3245204454921db1499735"
    }
  ],
  "headlines": [
    {
      "text": "Book a free demo",
      "_id": "6a3245204454921db1499735"
    }
  ],
  "descriptions": [
    {
      "text": "Book a free demo",
      "_id": "6a3245204454921db1499735"
    }
  ],
  "primaryText": "Get an instant estimate",
  "headline": "Free home valuation",
  "description": "Fast and hassle-free",
  "media": [
    {
      "type": "image",
      "src": "https://staging.files.leadconnectorhq.com/file/abc/def.jpeg",
      "name": "creative.jpeg",
      "_id": "6a859661867e604d24f4d73d"
    }
  ],
  "destinationFormId": "36267736432839880",
  "destinationLink": null,
  "unpublishedChanges": false,
  "createdAt": "2026-06-17T06:31:27.661Z",
  "updatedAt": "2026-08-19T11:45:39.340Z"
}