v8

OpenAPI 3.1.02026-08-033623795.0 MB
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.

Response

ad group duplication started

Example response

{
  "data": [
    {
      "bid_type": "minimum_cost",
      "budget_type": "daily",
      "conversion_location": "website",
      "delivery_status": "all_ads_rejected",
      "demographics": {
        "gender": "all"
      },
      "detailed_targeting": {
        "demographics": [
          {
            "type": "life_events"
          }
        ]
      },
      "devices": {
        "operating_systems": [
          {
            "os": "ios"
          }
        ],
        "platforms": [
          "mobile"
        ]
      },
      "issues": [
        {
          "resource_type": "ad_campaign"
        }
      ],
      "message_apps": [
        "messenger"
      ],
      "optimization_goal": "conversions",
      "placements": [
        {
          "platform": "facebook"
        }
      ],
      "regions": {
        "exclude": {
          "custom_locations": [
            {
              "distance_unit": "mile"
            }
          ]
        },
        "include": {
          "custom_locations": [
            {
              "distance_unit": "mile"
            }
          ]
        }
      },
      "result_event": "purchase",
      "status": "active"
    }
  ]
}