Ads

Duplicate a Meta Ads ad, ad set or campaign via API

Clone an ad, an ad set or a campaign in the client's account without rebuilding everything. You can adjust name, budget, schedule or the target campaign in the same call. The copy is created paused, so nothing spends until you activate it.

The request

POST /api/ads/{id}/duplicate?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>

{
  "name": "Black Friday, copy"
}

What you can do

  • Duplicate an ad with POST /ads/{id}/duplicate.
  • Duplicate an ad set with POST /ads/adsets/{id}/duplicate, choosing another target campaign with campaign_id.
  • Duplicate a campaign with POST /ads/campaigns/{id}/duplicate.
  • Change the copy's name and, for ad sets and campaigns, the budget.
  • Change the start date of a copied ad set.
  • Use the platform's numeric id or the Connect uuid.

Rules and limits

  • Idempotency-Key is required in the header; repeating with the same key returns 200 with Idempotent-Replay: true and does not create another copy.
  • An ad's copy is always created paused, in the same ad set. For ad sets and campaigns, status defaults to paused.
  • name is required when duplicating an ad set or a campaign, and optional when duplicating an ad.
  • The budget follows the CBO/ABO rule: sending it to the wrong level returns 409 budget_level_mismatch.
  • The object must exist in the connection's account; an id from another account returns 404 ads_object_not_found.
  • The response is synchronous (201).

Main fields

FieldTypeRequiredDescription
idstringYesIn the path: the id of the ad, ad set or campaign to copy (or the Connect uuid).
namestringYesName of the copy. Optional when duplicating an ad (without it the platform assigns one); required for ad sets and campaigns.
statusstringNoAd sets and campaigns only: paused (default) or active.
campaign_idstringNoAd sets only: the target campaign. Without it, the copy stays in the source's campaign.
budget.amountnumberNoAd sets and campaigns only: new budget, in the account's currency.
schedule.startstringNoAd sets only: new start date.

Who it is for

  • Scale what works

    Duplicate a winning ad set with a bigger budget or another target campaign, and activate it when ready.

  • Creative tests

    Copy an ad and then change the copy's text or headline to compare variations.

  • Per-client templates

    Keep a template campaign and duplicate it for each new client, changing only the name and budget.

Works with

  • Meta Ads

Frequently asked questions

Does the copy start spending?

An ad's copy is always created paused. For ad sets and campaigns the default is also paused, and it only activates if you send status active.

Can I duplicate a campaign created outside Connect?

Yes, as long as the id belongs to an object in the connected account. The platform's numeric id works for any object in the account.

What if I repeat the call by mistake?

With the same Idempotency-Key, the repeat returns the first response and does not create another copy.

Related

See everything you can do with Ads

See Connect applied to your product.

Try it for 15 days with no card, or walk our team through your use case.