v2

latestOpenAPI 3.1.02026-08-075421692.0 MB
Ad Campaigns

Duplicate an ad

Duplicates a single ad via Meta's native POST /{ad-id}/copies. The copy is created paused. adSetId retargets the copy into another ad set; omitted = the source's own ad set. Accepts the Zernio ad id or the platform ad id. Sync discovery is triggered automatically (syncAfter: false to skip).

post/v1/ads/{adId}/duplicate

Path parameters

adIdstring required

Zernio ad ID or platform ad ID

Headers

Idempotency-Keystring

Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.

Request body

adSetIdstring

Destination platform ad set id (defaults to the source's ad set)

statusOption'ACTIVE' | 'PAUSED' | 'INHERITED_FROM_SOURCE'
renameStrategy'DEEP_RENAME' | 'ONLY_TOP_LEVEL_RENAME' | 'NO_RENAME'
renamePrefixstring
renameSuffixstring
syncAfterboolean

Response

Ad duplicated

copiedAdIdstring

Platform ID of the new ad

discovery'triggered' | 'skipped' | 'failed'
rawobject