--- title: "Changes to Create/update ad entities in bulk" method: POST path: "/ad_accounts/{ad_account_id}/bulk/upsert" --- # Changes to Create/update ad entities in bulk `POST /ad_accounts/{ad_account_id}/bulk/upsert` > Every recorded change to this operation, newest first. ## Timeline Changed in 16 of 29 revisions. - **2026-06-04** (v5) `b698c180678a`: 59 breaking, 10 warning, 359 info - **2025-12-11** (v5) `537bde5a50b1`: 3 breaking, 4 info - **2025-12-10** (v5) `6768e3ca1ffa`: 4 info - **2025-10-16** (v5) `14c297539b64`: 1 warning, 20 info - **2025-08-14** (v5) `7d64d863909a`: 2 info - **2025-08-12** (v5) `8fb7ab040159`: 2 info - **2025-07-16** (v5) `43134ca41f18`: 4 breaking, 1 warning, 10 info - **2025-04-04** (v5) `10f9eba4ad97`: 7 warning, 63 info - **2024-08-14** (v5) `89c27ed39cfd`: 2 breaking, 13 warning, 17 info - **2024-04-23** (v5) `f9321315766f`: 9 breaking, 21 warning, 4 info - **2024-02-08** (v5) `7529b464d5cb`: 21 breaking, 2 warning, 37 info - **2023-08-17** (v5) `0ff12596bafd`: 4 info - **2023-07-14** (v5) `52586a274771`: 8 info - **2023-05-12** (v5) `689b4b267639`: 10 breaking, 1 warning, 29 info - **2023-02-14** (v5) `be19b77aa78a`: 3 breaking, 4 warning, 34 info - **2022-11-14** (v5) `e041d7b0cef0`: 1 info ## Changes - **2026-06-04** (v5) `b698c180678a`: 59 breaking, 10 warning, 359 info - added the new required request property `update/campaigns/items/allOf[subschema #3 -> subschema #1]/bid_options/update_mask` - added the new required request property `update/labels/items/parent_id` - added `#/components/schemas/Pinterest.Lib.IntegerFormatType` to the `create/catalog_product_groups/items/oneOf[subschema #2: catalog based]/oneOf[subschema #1: retail_product_groups_create_request]/catalog_id` request property `allOf` list - added `#/components/schemas/Pinterest.Lib.IntegerFormatType` to the `create/catalog_product_groups/items/oneOf[subschema #2: catalog based]/oneOf[subschema #2: hotel_product_groups_create_request]/catalog_id` request property `allOf` list - added `#/components/schemas/Pinterest.Lib.IntegerFormatType` to the `create/catalog_product_groups/items/oneOf[subschema #2: catalog based]/oneOf[subschema #3: creative_assets_product_groups_create_request]/catalog_id` request property `allOf` list - removed `subschema #1: any_of, subschema #2: all_of` from the `create/catalog_product_groups/items/oneOf[subschema #1: retail feed based]/filters` request property `anyOf` list - removed `subschema #1: any_of, subschema #2: all_of` from the `create/catalog_product_groups/items/oneOf[subschema #2: catalog based]/oneOf[subschema #1: retail_product_groups_create_request]/filters` request property `anyOf` list - removed `subschema #1: any_of, subschema #2: all_of` from the `update/catalog_product_groups/items/oneOf[subschema #1: retail feed based]/filters` request property `anyOf` list - removed `subschema #1: any_of, subschema #2: all_of` from the `update/catalog_product_groups/items/oneOf[subschema #2: catalog based]/oneOf[subschema #1: retail_product_groups_update_request]/filters` request property `anyOf` list - the request property `create/labels/items/labels/items/label_type` became not nullable - the request property `create/product_groups/items/product_group_promotion/items/bid_in_micro_currency` became not nullable - the request property `create/product_groups/items/product_group_promotion/items/catalog_product_group_id` became not nullable - the request property `create/product_groups/items/product_group_promotion/items/catalog_product_group_name` became not nullable - the request property `create/product_groups/items/product_group_promotion/items/customizable_cta_type` became not nullable - the request property `create/product_groups/items/product_group_promotion/items/definition` became not nullable - the request property `create/product_groups/items/product_group_promotion/items/included` became not nullable - the request property `create/product_groups/items/product_group_promotion/items/is_mdl` became not nullable - the request property `create/product_groups/items/product_group_promotion/items/parent_id` became not nullable - the request property `create/product_groups/items/product_group_promotion/items/relative_definition` became not nullable - the request property `create/product_groups/items/product_group_promotion/items/tracking_url` became not nullable - the request property `update/product_groups/items/product_group_promotion/items/bid_in_micro_currency` became not nullable - the request property `update/product_groups/items/product_group_promotion/items/catalog_product_group_id` became not nullable - the request property `update/product_groups/items/product_group_promotion/items/catalog_product_group_name` became not nullable - the request property `update/product_groups/items/product_group_promotion/items/customizable_cta_type` became not nullable - the request property `update/product_groups/items/product_group_promotion/items/definition` became not nullable - the request property `update/product_groups/items/product_group_promotion/items/included` became not nullable - the request property `update/product_groups/items/product_group_promotion/items/is_mdl` became not nullable - the request property `update/product_groups/items/product_group_promotion/items/parent_id` became not nullable - the request property `update/product_groups/items/product_group_promotion/items/relative_definition` became not nullable - the request property `update/product_groups/items/product_group_promotion/items/tracking_url` became not nullable - the request property `update/labels/items/status` became required - removed the enum value `undefined` of the request property `create/labels/items/labels/items/label_type` - removed the enum value `undefined` of the request property `create/product_groups/items/product_group_promotion/items/customizable_cta_type` - removed the enum value `undefined` of the request property `update/product_groups/items/product_group_promotion/items/customizable_cta_type` - the `create/ad_groups/items/allOf[subschema #2 -> subschema #1]/budget_type` request property type changed from `string` to no type - the `create/ad_groups/items/allOf[subschema #2 -> subschema #1]/pacing_delivery_type` request property type changed from `string` to no type - the `create/campaigns/items/allOf[subschema #2 -> subschema #1]/is_automated_campaign` request property type changed from `boolean` to no type - the `create/campaigns/items/allOf[subschema #2 -> subschema #1]/is_flexible_daily_budgets` request property type changed from `boolean` to no type - the `create/campaigns/items/allOf[subschema #2 -> subschema #1]/status` request property type changed from `string` to no type - the `create/catalog_product_groups/items/oneOf[subschema #1: retail feed based]/filters` request property type changed from `object` to no type - …388 more - **2025-12-11** (v5) `537bde5a50b1`: 3 breaking, 4 info - the request property `update/labels/items/status` became not nullable - removed the enum value `ACTIVE` of the request property `update/labels/items/status` - removed the enum value `undefined` of the request property `update/labels/items/status` - added the new optional request property `create/ads/items/allOf[#/components/schemas/AdCommon]/disclosure_type` - added the new optional request property `create/ads/items/allOf[#/components/schemas/AdCommon]/disclosure_url` - added the new optional request property `update/ads/items/allOf[#/components/schemas/AdCommon]/disclosure_type` - added the new optional request property `update/ads/items/allOf[#/components/schemas/AdCommon]/disclosure_url` - **2025-12-10** (v5) `6768e3ca1ffa`: 4 info - added the new optional request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/MAXIMUM_AGE` - added the new optional request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/MINIMUM_AGE` - added the new optional request property `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/MAXIMUM_AGE` - added the new optional request property `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/MINIMUM_AGE` - **2025-10-16** (v5) `14c297539b64`: 1 warning, 20 info - changed the pattern of the request property `create/labels/items/parent_id` from `^\d+$` to `^[C]?\d+$` - added the new optional request property `create/catalog_product_groups` - added the new optional request property `update/catalog_product_groups` - the request property `create/labels/items/labels/items/label_type` became nullable - the request property `update/labels/items/status` became nullable - added the new `BUY_ONLINE_PICKUP_IN_STORE` enum value to the request property `create/product_groups/items/product_group_promotion/items/customizable_cta_type` - added the new `BUY_ONLINE_PICKUP_IN_STORE` enum value to the request property `update/product_groups/items/product_group_promotion/items/customizable_cta_type` - added the new `COLLAGE` enum value to the request property `create/ads/items/allOf[#/components/schemas/AdCommon]/creative_type` - added the new `COLLAGE` enum value to the request property `create/product_groups/items/product_group_promotion/items/creative_type` - added the new `COLLAGE` enum value to the request property `update/ads/items/allOf[#/components/schemas/AdCommon]/creative_type` - added the new `COLLAGE` enum value to the request property `update/product_groups/items/product_group_promotion/items/creative_type` - added the new `MAX_WIDTH_REGULAR_COLLECTION` enum value to the request property `create/ads/items/allOf[#/components/schemas/AdCommon]/creative_type` - added the new `MAX_WIDTH_REGULAR_COLLECTION` enum value to the request property `create/product_groups/items/product_group_promotion/items/creative_type` - added the new `MAX_WIDTH_REGULAR_COLLECTION` enum value to the request property `update/ads/items/allOf[#/components/schemas/AdCommon]/creative_type` - added the new `MAX_WIDTH_REGULAR_COLLECTION` enum value to the request property `update/product_groups/items/product_group_promotion/items/creative_type` - added the new `MAX_WIDTH_VIDEO_COLLECTION` enum value to the request property `create/ads/items/allOf[#/components/schemas/AdCommon]/creative_type` - added the new `MAX_WIDTH_VIDEO_COLLECTION` enum value to the request property `create/product_groups/items/product_group_promotion/items/creative_type` - added the new `MAX_WIDTH_VIDEO_COLLECTION` enum value to the request property `update/ads/items/allOf[#/components/schemas/AdCommon]/creative_type` - added the new `MAX_WIDTH_VIDEO_COLLECTION` enum value to the request property `update/product_groups/items/product_group_promotion/items/creative_type` - added the new `undefined` enum value to the request property `create/labels/items/labels/items/label_type` - added the new `undefined` enum value to the request property `update/labels/items/status` - **2025-08-14** (v5) `7d64d863909a`: 2 info - added the new optional request property `create/labels` - added the new optional request property `update/labels` - **2025-08-12** (v5) `8fb7ab040159`: 2 info - added the new optional request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/optimization_goal_metadata/allOf[#/components/schemas/OptimizationGoalMetadata]/conversion_tag_v3_goal_metadata/reporting_event` - added the new optional request property `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/optimization_goal_metadata/allOf[#/components/schemas/OptimizationGoalMetadata]/conversion_tag_v3_goal_metadata/reporting_event` - **2025-07-16** (v5) `43134ca41f18`: 4 breaking, 1 warning, 10 info - removed the enum value `VIDEO_VIEW` of the request property `create/campaigns/items/allOf[subschema #2]/objective_type` - removed the enum value `VIDEO_VIEW` of the request property `update/campaigns/items/allOf[subschema #3]/objective_type/allOf[#/components/schemas/ObjectiveType]/` - removed the enum value `WEB_SESSIONS` of the request property `create/campaigns/items/allOf[subschema #2]/objective_type` - removed the enum value `WEB_SESSIONS` of the request property `update/campaigns/items/allOf[subschema #3]/objective_type/allOf[#/components/schemas/ObjectiveType]/` - removed the request property `update/campaigns/items/allOf[subschema #3]/is_campaign_budget_optimization` - added the new optional request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/promotion_application_level` - added the new optional request property `create/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[subschema #2]/is_campaign_budget_optimization` - added the new optional request property `create/campaigns/items/allOf[subschema #2]/bid_options` - added the new optional request property `create/product_groups/items/product_group_promotion/items/preferred_media_type` - added the new optional request property `create/product_groups/items/product_group_promotion/items/selected_video_tag` - added the new optional request property `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/promotion_application_level` - added the new optional request property `update/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[subschema #2]/is_campaign_budget_optimization` - added the new optional request property `update/campaigns/items/allOf[subschema #3]/bid_options` - added the new optional request property `update/product_groups/items/product_group_promotion/items/preferred_media_type` - added the new optional request property `update/product_groups/items/product_group_promotion/items/selected_video_tag` - **2025-04-04** (v5) `10f9eba4ad97`: 7 warning, 63 info - removed `#/components/schemas/ProductGroupPromotion, subschema #2` from the `create/product_groups/items/product_group_promotion/items/` request property `allOf` list - the `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/optimization_goal_metadata/allOf[#/components/schemas/OptimizationGoalMetadata]/frequency_goal_metadata/frequency` request property's max was set to `20.00` - the `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/optimization_goal_metadata/allOf[#/components/schemas/OptimizationGoalMetadata]/frequency_goal_metadata/frequency` request property's max was set to `20.00` - the `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/optimization_goal_metadata/allOf[#/components/schemas/OptimizationGoalMetadata]/frequency_goal_metadata/frequency` request property's min was set to `2.00` - the `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/optimization_goal_metadata/allOf[#/components/schemas/OptimizationGoalMetadata]/frequency_goal_metadata/frequency` request property's min was set to `2.00` - removed the request property `create/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[subschema #2]/is_automated_campaign` - removed the request property `update/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[subschema #2]/is_automated_campaign` - added the new optional request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/is_creative_optimization` - added the new optional request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/promotion_id` - added the new optional request property `create/ad_groups/items/allOf[subschema #2]/bid_multiplier` - added the new optional request property `create/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[#/components/schemas/CampaignCommon]/is_automated_campaign` - added the new optional request property `create/campaigns/items/allOf[subschema #2]/is_performance_plus` - added the new optional request property `create/product_groups/items/product_group_promotion/items/ad_group_id` - added the new optional request property `create/product_groups/items/product_group_promotion/items/bid_in_micro_currency` - added the new optional request property `create/product_groups/items/product_group_promotion/items/catalog_product_group_id` - added the new optional request property `create/product_groups/items/product_group_promotion/items/catalog_product_group_name` - added the new optional request property `create/product_groups/items/product_group_promotion/items/collections_header_type` - added the new optional request property `create/product_groups/items/product_group_promotion/items/collections_hero_destination_url` - added the new optional request property `create/product_groups/items/product_group_promotion/items/collections_hero_pin_id` - added the new optional request property `create/product_groups/items/product_group_promotion/items/creative_type` - added the new optional request property `create/product_groups/items/product_group_promotion/items/customizable_cta_type` - added the new optional request property `create/product_groups/items/product_group_promotion/items/definition` - added the new optional request property `create/product_groups/items/product_group_promotion/items/grid_click_type` - added the new optional request property `create/product_groups/items/product_group_promotion/items/id` - added the new optional request property `create/product_groups/items/product_group_promotion/items/included` - added the new optional request property `create/product_groups/items/product_group_promotion/items/is_generate_background` - added the new optional request property `create/product_groups/items/product_group_promotion/items/is_mdl` - added the new optional request property `create/product_groups/items/product_group_promotion/items/parent_id` - added the new optional request property `create/product_groups/items/product_group_promotion/items/relative_definition` - added the new optional request property `create/product_groups/items/product_group_promotion/items/selected_image_tag` - added the new optional request property `create/product_groups/items/product_group_promotion/items/slideshow_collections_description` - added the new optional request property `create/product_groups/items/product_group_promotion/items/slideshow_collections_title` - added the new optional request property `create/product_groups/items/product_group_promotion/items/status` - added the new optional request property `create/product_groups/items/product_group_promotion/items/tracking_url` - added the new optional request property `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/is_creative_optimization` - added the new optional request property `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/promotion_id` - added the new optional request property `update/ad_groups/items/allOf[subschema #2]/bid_multiplier` - added the new optional request property `update/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[#/components/schemas/CampaignCommon]/is_automated_campaign` - added the new optional request property `update/campaigns/items/allOf[subschema #3]/is_performance_plus` - added the new optional request property `update/product_groups/items/product_group_promotion/items/collections_header_type` - …30 more - **2024-08-14** (v5) `89c27ed39cfd`: 2 breaking, 13 warning, 17 info - removed the enum value `VISIT_WEBSITE` of the request property `create/ads/items/allOf[#/components/schemas/AdCommon]/customizable_cta_type` - removed the enum value `VISIT_WEBSITE` of the request property `update/ads/items/allOf[#/components/schemas/AdCommon]/customizable_cta_type` - removed `#/components/schemas/CampaignCommon` from the `update/campaigns/items/` request property `allOf` list - removed `#/components/schemas/CampaignIsAutomatedCampaign` from the `create/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[subschema #2]/is_automated_campaign` request property `allOf` list - removed `#/components/schemas/CampaignIsAutomatedCampaign` from the `update/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[subschema #2]/is_automated_campaign` request property `allOf` list - removed `#/components/schemas/CampaignIsCampaignBudgetOptimization` from the `update/campaigns/items/allOf[subschema #4 -> subschema #3]/is_campaign_budget_optimization` request property `allOf` list - removed the request property `create/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[#/components/schemas/CampaignCommon]/summary_status` - removed the request property `create/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[subschema #2]/is_flexible_daily_budgets` - removed the request property `create/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[subschema #2]/status` - removed the request property `update/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[#/components/schemas/CampaignCommon]/summary_status` - removed the request property `update/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[subschema #2]/is_flexible_daily_budgets` - removed the request property `update/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[subschema #2]/status` - removed the request property `update/campaigns/items/allOf[subschema #4 -> subschema #3]/is_automated_campaign` - removed the request property `update/campaigns/items/allOf[subschema #4 -> subschema #3]/is_flexible_daily_budgets` - removed the request property `update/campaigns/items/allOf[subschema #4 -> subschema #3]/status` - added the new optional request property `create/ads/items/allOf[#/components/schemas/AdCommon]/quiz_pin_data/allOf[#/components/schemas/QuizPinData]/tie_breaker_custom_result` - added the new optional request property `create/ads/items/allOf[#/components/schemas/AdCommon]/quiz_pin_data/allOf[#/components/schemas/QuizPinData]/tie_breaker_type` - added the new optional request property `create/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[#/components/schemas/CampaignCommon]/is_flexible_daily_budgets` - added the new optional request property `create/campaigns/items/allOf[subschema #2]/is_automated_campaign` - added the new optional request property `create/campaigns/items/allOf[subschema #2]/is_flexible_daily_budgets` - added the new optional request property `create/campaigns/items/allOf[subschema #2]/status` - added the new optional request property `update/ads/items/allOf[#/components/schemas/AdCommon]/quiz_pin_data/allOf[#/components/schemas/QuizPinData]/tie_breaker_custom_result` - added the new optional request property `update/ads/items/allOf[#/components/schemas/AdCommon]/quiz_pin_data/allOf[#/components/schemas/QuizPinData]/tie_breaker_type` - added the new optional request property `update/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[#/components/schemas/CampaignCommon]/is_flexible_daily_budgets` - the request property `create/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[subschema #2]/is_automated_campaign` became nullable - the request property `update/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[subschema #2]/is_automated_campaign` became nullable - the `is_automated_campaign` request property default value `false` was removed - the `is_automated_campaign` request property default value `false` was removed - added the new `VIDEO_COMPLETION` enum value to the request property `create/campaigns/items/allOf[subschema #2]/objective_type` - added the new `VIDEO_COMPLETION` enum value to the request property `update/campaigns/items/allOf[subschema #4 -> subschema #3]/objective_type/allOf[#/components/schemas/ObjectiveType]/` - added the new `VISIT_SITE` enum value to the request property `create/ads/items/allOf[#/components/schemas/AdCommon]/customizable_cta_type` - added the new `VISIT_SITE` enum value to the request property `update/ads/items/allOf[#/components/schemas/AdCommon]/customizable_cta_type` - **2024-04-23** (v5) `f9321315766f`: 9 breaking, 21 warning, 4 info - added `#/components/schemas/ProductGroupPromotion, subschema #2` to the `create/product_groups/items/product_group_promotion/items/` request property `allOf` list - the `create/ad_groups/items/` request property type changed from no type to `object` - the `create/ads/items/` request property type changed from no type to `object` - the `create/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[subschema #2]/` request property type changed from no type to `object` - the `create/campaigns/items/allOf[subschema #2]/` request property type changed from no type to `object` - the `update/ad_groups/items/` request property type changed from no type to `object` - the `update/ads/items/` request property type changed from no type to `object` - the `update/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[subschema #2]/` request property type changed from no type to `object` - the `update/campaigns/items/allOf[subschema #4]/` request property type changed from no type to `object` - removed the request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/AUDIENCE_INCLUDE'` - removed the request property `create/product_groups/items/product_group_promotion/items/ad_group_id` - removed the request property `create/product_groups/items/product_group_promotion/items/bid_in_micro_currency` - removed the request property `create/product_groups/items/product_group_promotion/items/catalog_product_group_id` - removed the request property `create/product_groups/items/product_group_promotion/items/catalog_product_group_name` - removed the request property `create/product_groups/items/product_group_promotion/items/collections_hero_destination_url` - removed the request property `create/product_groups/items/product_group_promotion/items/collections_hero_pin_id` - removed the request property `create/product_groups/items/product_group_promotion/items/creative_type` - removed the request property `create/product_groups/items/product_group_promotion/items/definition` - removed the request property `create/product_groups/items/product_group_promotion/items/grid_click_type` - removed the request property `create/product_groups/items/product_group_promotion/items/id` - removed the request property `create/product_groups/items/product_group_promotion/items/included` - removed the request property `create/product_groups/items/product_group_promotion/items/is_mdl` - removed the request property `create/product_groups/items/product_group_promotion/items/parent_id` - removed the request property `create/product_groups/items/product_group_promotion/items/relative_definition` - removed the request property `create/product_groups/items/product_group_promotion/items/slideshow_collections_description` - removed the request property `create/product_groups/items/product_group_promotion/items/slideshow_collections_title` - removed the request property `create/product_groups/items/product_group_promotion/items/status` - removed the request property `create/product_groups/items/product_group_promotion/items/tracking_url` - removed the request property `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/AUDIENCE_INCLUDE'` - removed the request property `update/product_groups/items/product_group_promotion/items/creative_type` - added the new optional request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/AUDIENCE_INCLUDE` - added the new optional request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_template_ids` - added the new optional request property `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/AUDIENCE_INCLUDE` - added the new optional request property `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_template_ids` - **2024-02-08** (v5) `7529b464d5cb`: 21 breaking, 2 warning, 37 info - added `#/components/schemas/CampaignSummaryStatus` to the `create/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[#/components/schemas/CampaignCommon]/summary_status` request property `allOf` list - added `#/components/schemas/CampaignSummaryStatus` to the `update/campaigns/items/allOf[#/components/schemas/CampaignCommon]/summary_status` request property `allOf` list - added `#/components/schemas/CampaignSummaryStatus` to the `update/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[#/components/schemas/CampaignCommon]/summary_status` request property `allOf` list - removed the enum value `ADVERTISER_DISABLED` of the request property `create/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[#/components/schemas/CampaignCommon]/summary_status` - removed the enum value `ADVERTISER_DISABLED` of the request property `update/campaigns/items/allOf[#/components/schemas/CampaignCommon]/summary_status` - removed the enum value `ADVERTISER_DISABLED` of the request property `update/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[#/components/schemas/CampaignCommon]/summary_status` - removed the enum value `ARCHIVED` of the request property `create/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[#/components/schemas/CampaignCommon]/summary_status` - removed the enum value `ARCHIVED` of the request property `update/campaigns/items/allOf[#/components/schemas/CampaignCommon]/summary_status` - removed the enum value `ARCHIVED` of the request property `update/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[#/components/schemas/CampaignCommon]/summary_status` - removed the enum value `COMPLETED` of the request property `create/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[#/components/schemas/CampaignCommon]/summary_status` - removed the enum value `COMPLETED` of the request property `update/campaigns/items/allOf[#/components/schemas/CampaignCommon]/summary_status` - removed the enum value `COMPLETED` of the request property `update/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[#/components/schemas/CampaignCommon]/summary_status` - removed the enum value `NOT_STARTED` of the request property `create/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[#/components/schemas/CampaignCommon]/summary_status` - removed the enum value `NOT_STARTED` of the request property `update/campaigns/items/allOf[#/components/schemas/CampaignCommon]/summary_status` - removed the enum value `NOT_STARTED` of the request property `update/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[#/components/schemas/CampaignCommon]/summary_status` - removed the enum value `PAUSED` of the request property `create/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[#/components/schemas/CampaignCommon]/summary_status` - removed the enum value `PAUSED` of the request property `update/campaigns/items/allOf[#/components/schemas/CampaignCommon]/summary_status` - removed the enum value `PAUSED` of the request property `update/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[#/components/schemas/CampaignCommon]/summary_status` - removed the enum value `RUNNING` of the request property `create/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[#/components/schemas/CampaignCommon]/summary_status` - removed the enum value `RUNNING` of the request property `update/campaigns/items/allOf[#/components/schemas/CampaignCommon]/summary_status` - removed the enum value `RUNNING` of the request property `update/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[#/components/schemas/CampaignCommon]/summary_status` - removed the request property `create/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[subschema #2]/is_campaign_budget_optimization` - removed the request property `update/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[subschema #2]/is_campaign_budget_optimization` - added the new optional request property `create/ads/items/allOf[#/components/schemas/AdCommon]/customizable_cta_type` - added the new optional request property `create/ads/items/allOf[#/components/schemas/AdCommon]/grid_click_type` - added the new optional request property `create/ads/items/allOf[#/components/schemas/AdCommon]/quiz_pin_data` - added the new optional request property `create/product_groups/items/product_group_promotion/items/grid_click_type` - added the new optional request property `update/ads/items/allOf[#/components/schemas/AdCommon]/customizable_cta_type` - added the new optional request property `update/ads/items/allOf[#/components/schemas/AdCommon]/grid_click_type` - added the new optional request property `update/ads/items/allOf[#/components/schemas/AdCommon]/quiz_pin_data` - added the new optional request property `update/ads/items/allOf[subschema #2: AdUpdateRequest]/pin_id` - added the new optional request property `update/campaigns/items/allOf[subschema #4]/objective_type` - added the new optional request property `update/product_groups/items/product_group_promotion/items/grid_click_type` - the `` request property default value `ALL` was added - the `` request property default value `ALL` was added - the `auto_targeting_enabled` request property default value `true` was removed - added the new `DELETED_DRAFT` enum value to the request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/status/allOf[#/components/schemas/EntityStatus]/` - added the new `DELETED_DRAFT` enum value to the request property `create/ads/items/allOf[#/components/schemas/AdCommon]/status` - added the new `DELETED_DRAFT` enum value to the request property `create/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[#/components/schemas/CampaignCommon]/status/allOf[#/components/schemas/EntityStatus]/` - added the new `DELETED_DRAFT` enum value to the request property `create/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[subschema #2]/status/allOf[#/components/schemas/EntityStatus]/` - …20 more - **2023-08-17** (v5) `0ff12596bafd`: 4 info - added the new optional request property `create/ads/items/allOf[#/components/schemas/AdCommon]/lead_form_id` - added the new optional request property `update/ads/items/allOf[#/components/schemas/AdCommon]/lead_form_id` - added the new `TWENTY_FOUR_HOUR` enum value to the request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/optimization_goal_metadata/allOf[#/components/schemas/OptimizationGoalMetadata]/frequency_goal_metadata/timerange` - added the new `TWENTY_FOUR_HOUR` enum value to the request property `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/optimization_goal_metadata/allOf[#/components/schemas/OptimizationGoalMetadata]/frequency_goal_metadata/timerange` - **2023-07-14** (v5) `52586a274771`: 8 info - added the new `COLLECTION` enum value to the request property `create/ads/items/allOf[#/components/schemas/AdCommon]/creative_type` - added the new `COLLECTION` enum value to the request property `create/product_groups/items/product_group_promotion/items/creative_type` - added the new `COLLECTION` enum value to the request property `update/ads/items/allOf[#/components/schemas/AdCommon]/creative_type` - added the new `COLLECTION` enum value to the request property `update/product_groups/items/product_group_promotion/items/creative_type` - added the new `SHOWCASE` enum value to the request property `create/ads/items/allOf[#/components/schemas/AdCommon]/creative_type` - added the new `SHOWCASE` enum value to the request property `create/product_groups/items/product_group_promotion/items/creative_type` - added the new `SHOWCASE` enum value to the request property `update/ads/items/allOf[#/components/schemas/AdCommon]/creative_type` - added the new `SHOWCASE` enum value to the request property `update/product_groups/items/product_group_promotion/items/creative_type` - **2023-05-12** (v5) `689b4b267639`: 10 breaking, 1 warning, 29 info - added `#/components/schemas/BudgetType` to the `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/budget_type` request property `allOf` list - added `#/components/schemas/BudgetType` to the `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/budget_type` request property `allOf` list - removed the enum value `BILLABLE_ENGAGEMENT` of the request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/billable_event` - removed the enum value `BILLABLE_ENGAGEMENT` of the request property `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/billable_event` - removed the enum value `CBO_ADGROUP` of the request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/budget_type` - removed the enum value `CBO_ADGROUP` of the request property `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/budget_type` - removed the enum value `DAILY` of the request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/budget_type` - removed the enum value `DAILY` of the request property `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/budget_type` - removed the enum value `LIFETIME` of the request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/budget_type` - removed the enum value `LIFETIME` of the request property `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/budget_type` - removed the request property `create/ad_groups/items/allOf[subschema #2]/targeting_spec` - added the new optional request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/AGE_BUCKET` - added the new optional request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/APPTYPE` - added the new optional request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/AUDIENCE_EXCLUDE` - added the new optional request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/AUDIENCE_INCLUDE'` - added the new optional request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/GENDER` - added the new optional request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/GEO` - added the new optional request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/INTEREST` - added the new optional request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/LOCALE` - added the new optional request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/LOCATION` - added the new optional request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/SHOPPING_RETARGETING` - added the new optional request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/TARGETING_STRATEGY` - added the new optional request property `create/ad_groups/items/allOf[subschema #2]/auto_targeting_enabled` - added the new optional request property `create/ad_groups/items/allOf[subschema #2]/budget_type` - added the new optional request property `create/ad_groups/items/allOf[subschema #2]/pacing_delivery_type` - added the new optional request property `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/AGE_BUCKET` - added the new optional request property `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/APPTYPE` - added the new optional request property `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/AUDIENCE_EXCLUDE` - added the new optional request property `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/AUDIENCE_INCLUDE'` - added the new optional request property `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/GENDER` - added the new optional request property `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/GEO` - added the new optional request property `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/INTEREST` - added the new optional request property `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/LOCALE` - added the new optional request property `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/LOCATION` - added the new optional request property `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/SHOPPING_RETARGETING` - added the new optional request property `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/TARGETING_STRATEGY` - added the new `QUIZ` enum value to the request property `create/ads/items/allOf[#/components/schemas/AdCommon]/creative_type` - added the new `QUIZ` enum value to the request property `create/product_groups/items/product_group_promotion/items/creative_type` - added the new `QUIZ` enum value to the request property `update/ads/items/allOf[#/components/schemas/AdCommon]/creative_type` - added the new `QUIZ` enum value to the request property `update/product_groups/items/product_group_promotion/items/creative_type` - **2023-02-14** (v5) `be19b77aa78a`: 3 breaking, 4 warning, 34 info - added `#/components/schemas/AdPinId` to the `create/ads/items/` request property `allOf` list - added the pattern `^\d+$` to the request property `update/product_groups/items/product_group_promotion/items/id` - the `update/product_groups/items/product_group_promotion/items/` request property type changed from no type to `object` - removed the request property `create/ads/items/allOf[#/components/schemas/AdCommon]/pin_id` - removed the request property `create/product_groups/items/product_group_promotion/items/catalogs_product_group_id` - removed the request property `create/product_groups/items/product_group_promotion/items/catalogs_product_group_name` - removed the request property `update/ads/items/allOf[#/components/schemas/AdCommon]/pin_id` - added the new optional request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/optimization_goal_metadata` - added the new optional request property `create/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[#/components/schemas/CampaignCommon]/summary_status` - added the new optional request property `create/product_groups/items/product_group_promotion/items/ad_group_id` - added the new optional request property `create/product_groups/items/product_group_promotion/items/bid_in_micro_currency` - added the new optional request property `create/product_groups/items/product_group_promotion/items/catalog_product_group_id` - added the new optional request property `create/product_groups/items/product_group_promotion/items/catalog_product_group_name` - added the new optional request property `create/product_groups/items/product_group_promotion/items/definition` - added the new optional request property `create/product_groups/items/product_group_promotion/items/id` - added the new optional request property `create/product_groups/items/product_group_promotion/items/included` - added the new optional request property `create/product_groups/items/product_group_promotion/items/parent_id` - added the new optional request property `create/product_groups/items/product_group_promotion/items/relative_definition` - added the new optional request property `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/optimization_goal_metadata` - added the new optional request property `update/campaigns/items/allOf[#/components/schemas/CampaignCommon]/summary_status` - added the new optional request property `update/campaigns/items/allOf[#/components/schemas/CampaignCreateCommon]/allOf[#/components/schemas/CampaignCommon]/summary_status` - added the new optional request property `update/product_groups/items/product_group_promotion/items/ad_group_id` - added the new optional request property `update/product_groups/items/product_group_promotion/items/bid_in_micro_currency` - added the new optional request property `update/product_groups/items/product_group_promotion/items/catalog_product_group_id` - added the new optional request property `update/product_groups/items/product_group_promotion/items/catalog_product_group_name` - added the new optional request property `update/product_groups/items/product_group_promotion/items/collections_hero_destination_url` - added the new optional request property `update/product_groups/items/product_group_promotion/items/collections_hero_pin_id` - added the new optional request property `update/product_groups/items/product_group_promotion/items/creative_type` - added the new optional request property `update/product_groups/items/product_group_promotion/items/definition` - added the new optional request property `update/product_groups/items/product_group_promotion/items/included` - added the new optional request property `update/product_groups/items/product_group_promotion/items/is_mdl` - added the new optional request property `update/product_groups/items/product_group_promotion/items/parent_id` - added the new optional request property `update/product_groups/items/product_group_promotion/items/relative_definition` - added the new optional request property `update/product_groups/items/product_group_promotion/items/slideshow_collections_description` - added the new optional request property `update/product_groups/items/product_group_promotion/items/slideshow_collections_title` - added the new optional request property `update/product_groups/items/product_group_promotion/items/status` - added the new optional request property `update/product_groups/items/product_group_promotion/items/tracking_url` - the request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/bid_strategy_type` became nullable - the request property `update/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/bid_strategy_type` became nullable - added the new `undefined` enum value to the request property `create/ad_groups/items/allOf[#/components/schemas/AdGroupCommon]/bid_strategy_type` - …1 more - **2022-11-14** (v5) `e041d7b0cef0`: 1 info - endpoint added --- [Operation](https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/ad_accounts/:ad_account_id/bulk/upsert/post.md) - [API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) - [Page](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/ad_accounts/:ad_account_id/bulk/upsert/post)