Facebook AdsVersion: v3

Duplicate ad

POST/ad-publishing/facebook/ads/{adId}/duplicate

Duplicate an existing Facebook ad

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:adPublishing.write

Auth methods:OAuthPrivate Integration

Token type:Sub-Account Token

Request

Headers

Versionstringrequired

API Version

Available optionsv3

Example:v3

Path Parameters

adIdstringrequired

Ad identifier

Example:507f1f77bcf86cd799439013

Body

application/json

locationIdstringrequired

Location identifier

Example:HChooFuiyPpVYzeJ4HMe

Response

application/json

The duplicated ad, as a new draft

idstringrequired

Ad identifier

Example:6a323f3f4454921db1498ce1

namestringrequired

Ad name

Example:Ad 1

campaignIdstringrequired

Parent campaign id

Example:6a323f3e4454921db1498ccf

adsetIdstringrequired

Parent ad set id

Example:6a323f3f4454921db1498cd8

fbAdIdstring

Facebook ad id, set once published

Example:120250378908850122

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

Example:PUBLISHED

fbErrorstringnullable

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

Example:null

mediaTypestringrequired

Creative format

Example:SINGLE

ctastring

Call-to-action button

Example:GET_OFFER

multiAdvertiserAdsbooleanrequired

Whether multi-advertiser ads are enabled

Example:true

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.

Example:Get an instant estimate

headlinestring

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

Example:Free home valuation

descriptionstring

Single description

Example:Fast and hassle-free

mediaobject[]required

Creative media

destinationFormIdstring

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

Example:36267736432839880

destinationLinkstringnullable

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

Example:null

unpublishedChangesboolean

Whether the ad has edits not yet published

Example:false

createdAtstringrequired

Created at

Example:2026-06-17T06:31:27.661Z

updatedAtstringrequired

Updated at

Example:2026-08-19T11:45:39.340Z