Create product group promotions

POST {{baseUrl}}/ad_accounts/:ad_account_id/product_group_promotions

Add one or more product groups from your catalog to an existing ad group. (Product groups added to an ad group are a 'product group promotion.')

Request Body

{"ad_group_id"=>"AG647828", "product_group_promotion"=>[{"id"=>"27", "ad_group_id"=>"42430772", "bid_in_micro_currency"=>"<integer>", "included"=>"<boolean>", "definition"=>"<string>", "relative_definition"=>"<string>", "parent_id"=>"345946", "slideshow_collections_title"=>"<string>", "slideshow_collections_description"=>"<string>", "is_mdl"=>"<boolean>", "status"=>"PAUSED", "tracking_url"=>"<string>", "catalog_product_group_id"=>"575880", "catalog_product_group_name"=>"<string>", "creative_type"=>"CAROUSEL", "collections_hero_pin_id"=>"671122024", "collections_hero_destination_url"=>"<string>"}, {"id"=>"8885", "ad_group_id"=>"2", "bid_in_micro_currency"=>"<integer>", "included"=>"<boolean>", "definition"=>"<string>", "relative_definition"=>"<string>", "parent_id"=>"9601", "slideshow_collections_title"=>"<string>", "slideshow_collections_description"=>"<string>", "is_mdl"=>"<boolean>", "status"=>"PAUSED", "tracking_url"=>"<string>", "catalog_product_group_id"=>"62175867780", "catalog_product_group_name"=>"<string>", "creative_type"=>"VIDEO", "collections_hero_pin_id"=>"024", "collections_hero_destination_url"=>"<string>"}]}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;items&quot;:[{&quot;data&quot;:{&quot;id&quot;:&quot;6122206878&quot;,&quot;ad_group_id&quot;:&quot;8810873&quot;,&quot;bid_in_micro_currency&quot;:&quot;\u003cinteger\u003e&quot;,&quot;included&quot;:&quot;\u003cboolean\u003e&quot;,&quot;definition&quot;:&quot;\u003cstring\u003e&quot;,&quot;relative_definition&quot;:&quot;\u003cstring\u003e&quot;,&quot;parent_id&quot;:&quot;8&quot;,&quot;slideshow_collections_title&quot;:&quot;\u003cstring\u003e&quot;,&quot;slideshow_collections_description&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_mdl&quot;:&quot;\u003cboolean\u003e&quot;,&quot;status&quot;:&quot;ARCHIVED&quot;,&quot;tracking_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;catalog_product_group_id&quot;:&quot;8468&quot;,&quot;catalog_product_group_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;creative_type&quot;:&quot;QUIZ&quot;,&quot;collections_hero_pin_id&quot;:&quot;51&quot;,&quot;collections_hero_destination_url&quot;:&quot;\u003cstring\u003e&quot;},&quot;exceptions&quot;:[{&quot;nullable&quot;:true},{&quot;nullable&quot;:true}]},{&quot;data&quot;:{&quot;id&quot;:&quot;82792710&quot;,&quot;ad_group_id&quot;:&quot;0528&quot;,&quot;bid_in_micro_currency&quot;:&quot;\u003cinteger\u003e&quot;,&quot;included&quot;:&quot;\u003cboolean\u003e&quot;,&quot;definition&quot;:&quot;\u003cstring\u003e&quot;,&quot;relative_definition&quot;:&quot;\u003cstring\u003e&quot;,&quot;parent_id&quot;:&quot;96549941156&quot;,&quot;slideshow_collections_title&quot;:&quot;\u003cstring\u003e&quot;,&quot;slideshow_collections_description&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_mdl&quot;:&quot;\u003cboolean\u003e&quot;,&quot;status&quot;:&quot;ACTIVE&quot;,&quot;tracking_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;catalog_product_group_id&quot;:&quot;37138458&quot;,&quot;catalog_product_group_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;creative_type&quot;:&quot;MAX_VIDEO&quot;,&quot;collections_hero_pin_id&quot;:&quot;876786622&quot;,&quot;collections_hero_destination_url&quot;:&quot;\u003cstring\u003e&quot;},&quot;exceptions&quot;:[{&quot;nullable&quot;:true},{&quot;nullable&quot;:true}]}]}