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
| Field | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | In the path: the id of the ad, ad set or campaign to copy (or the Connect uuid). |
| name | string | Yes | Name of the copy. Optional when duplicating an ad (without it the platform assigns one); required for ad sets and campaigns. |
| status | string | No | Ad sets and campaigns only: paused (default) or active. |
| campaign_id | string | No | Ad sets only: the target campaign. Without it, the copy stays in the source's campaign. |
| budget.amount | number | No | Ad sets and campaigns only: new budget, in the account's currency. |
| schedule.start | string | No | Ad 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.
See Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
