latestOpenAPI 3.1.02026-08-153864115.7 MB

c301132dbfd7

Ad Groups

Duplicate an Ad Group

Creates copies of the ad group in duplicating status and returns them — into its own campaign, or into target_ad_campaign_id (which must belong to the same account and be compatible with the ad group's targeting and goals); each copy transitions to its final status (matching the source's active/paused state) once duplication completes. Poll each returned ad group until it leaves duplicating — a copy that could not be completed is deleted and returns 404.

post/ad_groups/{id}/duplicate

Headers

Idempotency-Keystring
Example:d9105228-4a08-46b1-8b91-42fed586d383

A unique key that makes this request safe to retry. See Idempotent requests.

Request body

countinteger

Number of copies to create (1-10). Defaults to 1.

preserve_engagementboolean

Whether the copied ads keep the original posts' engagement (likes, comments, shares). Defaults to false.

target_ad_campaign_idstring

Campaign to duplicate into. Defaults to the ad group's own campaign.

Example request

{
  "count": 2,
  "preserve_engagement": true,
  "target_ad_campaign_id": "adcamp_xxxxxxxxxxxxxx"
}

Response

ad group duplication started

Example response

{
  "data": [
    {
      "ad_campaign": {
        "id": "adcamp_xxxxxxxxxxxxxx"
      },
      "added_to_cart_value": 12650,
      "added_to_carts": 165,
      "audiences": {
        "exclude": [
          "adaud_xxxxxxxxxxxxxx"
        ],
        "include": [
          "adaud_xxxxxxxxxxxxxx"
        ]
      },
      "bid_type": "average_target",
      "budget_amount": 60,
      "budget_type": "daily",
      "click_through_rate": 0.025,
      "clicks": 5500,
      "completed_registration_value": 1650,
      "completed_registrations": 55,
      "contact_value": 2640,
      "contacts": 88,
      "conversion_event": "purchase",
      "conversion_location": "website",
      "cost_per_added_to_cart": 8,
      "cost_per_click": 0.24,
      "cost_per_completed_registration": 24,
      "cost_per_contact": 15,
      "cost_per_lead": 10,
      "cost_per_mille": 6,
      "cost_per_purchase": 30,
      "cost_per_result": 40,
      "cost_per_schedule": 22,
      "cost_per_submitted_application": 120,
      "cost_per_unique_click": 0.4,
      "cost_per_viewed_content": 1.1,
      "created_at": "2026-01-01T12:00:00.000Z",
      "custom_conversions": 41,
      "custom_event_counts": {
        "gift_card_purchased": 5,
        "quote_requested": 33
      },
      "custom_event_values": {
        "gift_card_purchased": 750,
        "quote_requested": 0
      },
      "delivery_status": "no_ads",
      "demographics": {
        "gender": "all",
        "maximum_age": 64,
        "minimum_age": 21
      },
      "desired_cost_per_result": 40,
      "detailed_targeting": {
        "behaviors": [
          {
            "id": "6003193685204",
            "name": "Car wash"
          }
        ],
        "demographics": [
          {
            "id": "6002714398172",
            "name": "Recently moved",
            "type": "life_events"
          }
        ],
        "interests": [
          {
            "id": "6003193685204",
            "name": "Car wash"
          }
        ]
      },
      "devices": {
        "operating_systems": [
          {
            "minimum_version": "18.0",
            "os": "ios"
          }
        ],
        "platforms": [
          "mobile"
        ]
      },
      "ends_at": "2026-01-01T12:00:00.000Z",
      "frequency_cap": {
        "maximum_impressions": 3,
        "per_days": 7
      },
      "id": "adgrp_xxxxxxxxxxxxxx",
      "impressions": 220000,
      "issues": [
        {
          "id": "adiss_xxxxxxxxxxxxxx",
          "message": "Your ad was rejected for unacceptable business practices. Edit the ad's content and resubmit.",
          "resource_id": "ad_xxxxxxxxxxxxxx",
          "resource_type": "ad"
        }
      ],
      "languages": [
        "en"
      ],
      "lead_value": 3960,
      "leads": 132,
      "message_apps": [
        "instagram"
      ],
      "minimum_daily_spend": 25,
      "optimization_goal": "conversions",
      "placements": [
        {
          "platform": "facebook",
          "positions": [
            "feed"
          ]
        }
      ],
      "purchase_value": 7920,
      "purchases": 44,
      "regions": {
        "exclude": {
          "cities": [
            {
              "key": "2418046",
              "name": "Austin"
            }
          ],
          "countries": [
            "US"
          ],
          "country_groups": [
            "north_america"
          ],
          "custom_locations": [
            {
              "distance_unit": "mile",
              "latitude": 30.2672,
              "longitude": -97.7431,
              "name": "4180 Burnet Rd, Austin TX 78756",
              "radius": 25
            }
          ],
          "regions": [
            "US-TX"
          ],
          "zips": [
            "78756"
          ]
        },
        "include": {
          "cities": [
            {
              "key": "2418046",
              "name": "Austin"
            }
          ],
          "countries": [
            "US"
          ],
          "country_groups": [
            "north_america"
          ],
          "custom_locations": [
            {
              "distance_unit": "mile",
              "latitude": 30.2672,
              "longitude": -97.7431,
              "name": "4180 Burnet Rd, Austin TX 78756",
              "radius": 25
            }
          ],
          "regions": [
            "US-TX"
          ],
          "zips": [
            "78756"
          ]
        }
      },
      "result_event": "custom",
      "result_event_name": "quote_requested",
      "results": 33,
      "return_on_ad_spend": 6,
      "schedule_value": 5400,
      "schedules": 60,
      "spend": 1320,
      "spend_currency": "usd",
      "starts_at": "2026-01-01T12:00:00.000Z",
      "status": "active",
      "submitted_application_value": 1320,
      "submitted_applications": 11,
      "title": "Austin ceramic coating — repeat customers",
      "unique_clicks": 3300,
      "updated_at": "2026-01-01T12:00:00.000Z",
      "viewed_content_value": 8400,
      "viewed_contents": 1200
    }
  ]
}