---
title: "Changes to Create product group"
method: POST
path: "/catalogs/product_groups"
---

# Changes to Create product group

`POST /catalogs/product_groups`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 11 of 29 revisions.

- **2026-06-04** (v5) `b698c180678a` — 31 breaking, 1 warning, 172 info
- **2025-07-16** (v5) `43134ca41f18` — 2 info
- **2025-04-04** (v5) `10f9eba4ad97` — 2 breaking, 66 info
- **2024-08-14** (v5) `89c27ed39cfd` — 2 breaking, 8 info
- **2024-04-23** (v5) `f9321315766f` — 3 breaking, 5 info
- **2024-02-08** (v5) `7529b464d5cb` — 3 breaking, 2 info
- **2023-07-14** (v5) `52586a274771` — 1 breaking, 12 warning, 1 info
- **2022-11-14** (v5) `e041d7b0cef0` — 1 info
- **2022-09-07** (v5) `bd20b6eb152f` — 4 warning
- **2022-07-11** (v5) `0d5998752011` — 2 breaking, 4 warning, 2 info
- **2022-04-12** (v5) `723c51158044` — 1 info

## Changes

- **2026-06-04** (v5) `b698c180678a` — 31 breaking, 1 warning, 172 info
  - added `#/components/schemas/Pinterest.Lib.IntegerFormatType` to the `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 `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 `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 `oneOf[subschema #1: retail feed based]/filters` request property `anyOf` list
  - removed `subschema #1: any_of, subschema #2: all_of` from the `oneOf[subschema #2: catalog based]/oneOf[subschema #1: retail_product_groups_create_request]/filters` request property `anyOf` list
  - the `oneOf[subschema #1: retail feed based]/filters` request property type/format changed from `object`/`` to ``/``
  - the `oneOf[subschema #2: catalog based]/oneOf[subschema #1: retail_product_groups_create_request]/catalog_id` request property type/format changed from `string`/`` to ``/``
  - the `oneOf[subschema #2: catalog based]/oneOf[subschema #1: retail_product_groups_create_request]/filters` request property type/format changed from `object`/`` to ``/``
  - the `oneOf[subschema #2: catalog based]/oneOf[subschema #2: hotel_product_groups_create_request]/catalog_id` request property type/format changed from `string`/`` to ``/``
  - the `oneOf[subschema #2: catalog based]/oneOf[subschema #2: hotel_product_groups_create_request]/filters` request property type/format changed from `object`/`` to ``/``
  - the `oneOf[subschema #2: catalog based]/oneOf[subschema #2: hotel_product_groups_create_request]/filters/anyOf[subschema #1: any_of]/any_of/items/` request property type/format changed from `object`/`` to ``/``
  - the `oneOf[subschema #2: catalog based]/oneOf[subschema #2: hotel_product_groups_create_request]/filters/anyOf[subschema #2: all_of]/all_of/items/` request property type/format changed from `object`/`` to ``/``
  - the `oneOf[subschema #2: catalog based]/oneOf[subschema #3: creative_assets_product_groups_create_request]/catalog_id` request property type/format changed from `string`/`` to ``/``
  - the `oneOf[subschema #2: catalog based]/oneOf[subschema #3: creative_assets_product_groups_create_request]/filters` request property type/format changed from `object`/`` to ``/``
  - the `oneOf[subschema #2: catalog based]/oneOf[subschema #3: creative_assets_product_groups_create_request]/filters/anyOf[subschema #1: any_of]/any_of/items/` request property type/format changed from `object`/`` to ``/``
  - the `oneOf[subschema #2: catalog based]/oneOf[subschema #3: creative_assets_product_groups_create_request]/filters/anyOf[subschema #2: all_of]/all_of/items/` request property type/format changed from `object`/`` to ``/``
  - the `oneOf[subschema #1: retail_product_group]/catalog_id` response's property type/format changed from `string`/`` to ``/`` for status `201`
  - the `oneOf[subschema #1: retail_product_group]/filters` response's property type/format changed from `object`/`` to ``/`` for status `201`
  - the `oneOf[subschema #1: retail_product_group]/filters/anyOf[subschema #1: any_of]/any_of/items/` response's property type/format changed from `object`/`` to ``/`` for status `201`
  - the `oneOf[subschema #1: retail_product_group]/filters/anyOf[subschema #2: all_of]/all_of/items/` response's property type/format changed from `object`/`` to ``/`` for status `201`
  - the `oneOf[subschema #1: retail_product_group]/id` response's property type/format changed from `string`/`` to ``/`` for status `201`
  - the `oneOf[subschema #2: hotel_product_group]/catalog_id` response's property type/format changed from `string`/`` to ``/`` for status `201`
  - the `oneOf[subschema #2: hotel_product_group]/filters` response's property type/format changed from `object`/`` to ``/`` for status `201`
  - the `oneOf[subschema #2: hotel_product_group]/filters/anyOf[subschema #1: any_of]/any_of/items/` response's property type/format changed from `object`/`` to ``/`` for status `201`
  - the `oneOf[subschema #2: hotel_product_group]/filters/anyOf[subschema #2: all_of]/all_of/items/` response's property type/format changed from `object`/`` to ``/`` for status `201`
  - the `oneOf[subschema #2: hotel_product_group]/id` response's property type/format changed from `string`/`` to ``/`` for status `201`
  - the `oneOf[subschema #3: creative_assets_product_group]/catalog_id` response's property type/format changed from `string`/`` to ``/`` for status `201`
  - the `oneOf[subschema #3: creative_assets_product_group]/filters` response's property type/format changed from `object`/`` to ``/`` for status `201`
  - the `oneOf[subschema #3: creative_assets_product_group]/filters/anyOf[subschema #1: any_of]/any_of/items/` response's property type/format changed from `object`/`` to ``/`` for status `201`
  - the `oneOf[subschema #3: creative_assets_product_group]/filters/anyOf[subschema #2: all_of]/all_of/items/` response's property type/format changed from `object`/`` to ``/`` for status `201`
  - the `oneOf[subschema #3: creative_assets_product_group]/id` response's property type/format changed from `string`/`` to ``/`` for status `201`
  - added the new `CATALOG_EXPANSION` enum value to the `oneOf[subschema #1: retail_product_group]/type` response property for the response status `201`
  - added `#/components/schemas/CatalogsProductGroupFiltersRequestAnyOfItems0, #/components/schemas/CatalogsProductGroupFiltersRequestAnyOfItems1` to the `oneOf[subschema #1: retail feed based]/filters` request property `anyOf` list
  - added `#/components/schemas/CatalogsProductGroupFiltersRequestAnyOfItems0, #/components/schemas/CatalogsProductGroupFiltersRequestAnyOfItems1` to the `oneOf[subschema #2: catalog based]/oneOf[subschema #1: retail_product_groups_create_request]/filters` request property `anyOf` list
  - added `#/components/schemas/LinkFilter` to the `oneOf[subschema #2: catalog based]/oneOf[subschema #3: creative_assets_product_groups_create_request]/filters/anyOf[subschema #1: any_of]/any_of/items/` request property `anyOf` list
  - added `#/components/schemas/LinkFilter` to the `oneOf[subschema #2: catalog based]/oneOf[subschema #3: creative_assets_product_groups_create_request]/filters/anyOf[subschema #2: all_of]/all_of/items/` request property `anyOf` list
  - the `filter_operator_type` request property default value `IS` was removed
  - the `filter_operator_type` request property default value `IS` was removed
  - the `filter_operator_type` request property default value `IS` was removed
  - the `filter_operator_type` request property default value `IS` was removed
  - …164 more
- **2025-07-16** (v5) `43134ca41f18` — 2 info
  - the request property `oneOf[subschema #2: catalog based]/oneOf[subschema #1: retail_product_groups_create_request]/country` became optional
  - the request property `oneOf[subschema #2: catalog based]/oneOf[subschema #1: retail_product_groups_create_request]/locale` became optional
- **2025-04-04** (v5) `10f9eba4ad97` — 2 breaking, 66 info
  - removed `subschema #1, subschema #2` from the `oneOf[subschema #1: retail feed based]/filters` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `oneOf[subschema #2: catalog based]/oneOf[subschema #1: retail_product_groups_create_request]/filters` request property `anyOf` list
  - api tag `catalog_product_groups` added
  - api tag `catalogs` removed
  - added the new optional request property `oneOf[subschema #2: catalog based]/oneOf[subschema #2: hotel_product_groups_create_request]/filters/anyOf[#/components/schemas/CatalogsHotelProductGroupFiltersAllOf -> subschema #2: all_of]/all_of/items/anyOf[#/components/schemas/CustomLabel0Filter -> subschema #4: CUSTOM_LABEL_0]/CUSTOM_LABEL_0/filter_operator_type`
  - added the new optional request property `oneOf[subschema #2: catalog based]/oneOf[subschema #2: hotel_product_groups_create_request]/filters/anyOf[#/components/schemas/CatalogsHotelProductGroupFiltersAllOf -> subschema #2: all_of]/all_of/items/anyOf[#/components/schemas/CustomLabel1Filter -> subschema #5: CUSTOM_LABEL_1]/CUSTOM_LABEL_1/filter_operator_type`
  - added the new optional request property `oneOf[subschema #2: catalog based]/oneOf[subschema #2: hotel_product_groups_create_request]/filters/anyOf[#/components/schemas/CatalogsHotelProductGroupFiltersAllOf -> subschema #2: all_of]/all_of/items/anyOf[#/components/schemas/CustomLabel2Filter -> subschema #6: CUSTOM_LABEL_2]/CUSTOM_LABEL_2/filter_operator_type`
  - added the new optional request property `oneOf[subschema #2: catalog based]/oneOf[subschema #2: hotel_product_groups_create_request]/filters/anyOf[#/components/schemas/CatalogsHotelProductGroupFiltersAllOf -> subschema #2: all_of]/all_of/items/anyOf[#/components/schemas/CustomLabel3Filter -> subschema #7: CUSTOM_LABEL_3]/CUSTOM_LABEL_3/filter_operator_type`
  - added the new optional request property `oneOf[subschema #2: catalog based]/oneOf[subschema #2: hotel_product_groups_create_request]/filters/anyOf[#/components/schemas/CatalogsHotelProductGroupFiltersAllOf -> subschema #2: all_of]/all_of/items/anyOf[#/components/schemas/CustomLabel4Filter -> subschema #8: CUSTOM_LABEL_4]/CUSTOM_LABEL_4/filter_operator_type`
  - added the new optional request property `oneOf[subschema #2: catalog based]/oneOf[subschema #2: hotel_product_groups_create_request]/filters/anyOf[#/components/schemas/CatalogsHotelProductGroupFiltersAnyOf -> subschema #1: any_of]/any_of/items/anyOf[#/components/schemas/CustomLabel0Filter -> subschema #4: CUSTOM_LABEL_0]/CUSTOM_LABEL_0/filter_operator_type`
  - added the new optional request property `oneOf[subschema #2: catalog based]/oneOf[subschema #2: hotel_product_groups_create_request]/filters/anyOf[#/components/schemas/CatalogsHotelProductGroupFiltersAnyOf -> subschema #1: any_of]/any_of/items/anyOf[#/components/schemas/CustomLabel1Filter -> subschema #5: CUSTOM_LABEL_1]/CUSTOM_LABEL_1/filter_operator_type`
  - added the new optional request property `oneOf[subschema #2: catalog based]/oneOf[subschema #2: hotel_product_groups_create_request]/filters/anyOf[#/components/schemas/CatalogsHotelProductGroupFiltersAnyOf -> subschema #1: any_of]/any_of/items/anyOf[#/components/schemas/CustomLabel2Filter -> subschema #6: CUSTOM_LABEL_2]/CUSTOM_LABEL_2/filter_operator_type`
  - added the new optional request property `oneOf[subschema #2: catalog based]/oneOf[subschema #2: hotel_product_groups_create_request]/filters/anyOf[#/components/schemas/CatalogsHotelProductGroupFiltersAnyOf -> subschema #1: any_of]/any_of/items/anyOf[#/components/schemas/CustomLabel3Filter -> subschema #7: CUSTOM_LABEL_3]/CUSTOM_LABEL_3/filter_operator_type`
  - added the new optional request property `oneOf[subschema #2: catalog based]/oneOf[subschema #2: hotel_product_groups_create_request]/filters/anyOf[#/components/schemas/CatalogsHotelProductGroupFiltersAnyOf -> subschema #1: any_of]/any_of/items/anyOf[#/components/schemas/CustomLabel4Filter -> subschema #8: CUSTOM_LABEL_4]/CUSTOM_LABEL_4/filter_operator_type`
  - added the new optional request property `oneOf[subschema #2: catalog based]/oneOf[subschema #3: creative_assets_product_groups_create_request]/filters/anyOf[#/components/schemas/CatalogsCreativeAssetsProductGroupFiltersAllOf -> subschema #2: all_of]/all_of/items/anyOf[#/components/schemas/CustomLabel0Filter -> subschema #2: CUSTOM_LABEL_0]/CUSTOM_LABEL_0/filter_operator_type`
  - added the new optional request property `oneOf[subschema #2: catalog based]/oneOf[subschema #3: creative_assets_product_groups_create_request]/filters/anyOf[#/components/schemas/CatalogsCreativeAssetsProductGroupFiltersAllOf -> subschema #2: all_of]/all_of/items/anyOf[#/components/schemas/CustomLabel1Filter -> subschema #3: CUSTOM_LABEL_1]/CUSTOM_LABEL_1/filter_operator_type`
  - added the new optional request property `oneOf[subschema #2: catalog based]/oneOf[subschema #3: creative_assets_product_groups_create_request]/filters/anyOf[#/components/schemas/CatalogsCreativeAssetsProductGroupFiltersAllOf -> subschema #2: all_of]/all_of/items/anyOf[#/components/schemas/CustomLabel2Filter -> subschema #4: CUSTOM_LABEL_2]/CUSTOM_LABEL_2/filter_operator_type`
  - added the new optional request property `oneOf[subschema #2: catalog based]/oneOf[subschema #3: creative_assets_product_groups_create_request]/filters/anyOf[#/components/schemas/CatalogsCreativeAssetsProductGroupFiltersAllOf -> subschema #2: all_of]/all_of/items/anyOf[#/components/schemas/CustomLabel3Filter -> subschema #5: CUSTOM_LABEL_3]/CUSTOM_LABEL_3/filter_operator_type`
  - added the new optional request property `oneOf[subschema #2: catalog based]/oneOf[subschema #3: creative_assets_product_groups_create_request]/filters/anyOf[#/components/schemas/CatalogsCreativeAssetsProductGroupFiltersAllOf -> subschema #2: all_of]/all_of/items/anyOf[#/components/schemas/CustomLabel4Filter -> subschema #6: CUSTOM_LABEL_4]/CUSTOM_LABEL_4/filter_operator_type`
  - added the new optional request property `oneOf[subschema #2: catalog based]/oneOf[subschema #3: creative_assets_product_groups_create_request]/filters/anyOf[#/components/schemas/CatalogsCreativeAssetsProductGroupFiltersAnyOf -> subschema #1: any_of]/any_of/items/anyOf[#/components/schemas/CustomLabel0Filter -> subschema #2: CUSTOM_LABEL_0]/CUSTOM_LABEL_0/filter_operator_type`
  - added the new optional request property `oneOf[subschema #2: catalog based]/oneOf[subschema #3: creative_assets_product_groups_create_request]/filters/anyOf[#/components/schemas/CatalogsCreativeAssetsProductGroupFiltersAnyOf -> subschema #1: any_of]/any_of/items/anyOf[#/components/schemas/CustomLabel1Filter -> subschema #3: CUSTOM_LABEL_1]/CUSTOM_LABEL_1/filter_operator_type`
  - added the new optional request property `oneOf[subschema #2: catalog based]/oneOf[subschema #3: creative_assets_product_groups_create_request]/filters/anyOf[#/components/schemas/CatalogsCreativeAssetsProductGroupFiltersAnyOf -> subschema #1: any_of]/any_of/items/anyOf[#/components/schemas/CustomLabel2Filter -> subschema #4: CUSTOM_LABEL_2]/CUSTOM_LABEL_2/filter_operator_type`
  - added the new optional request property `oneOf[subschema #2: catalog based]/oneOf[subschema #3: creative_assets_product_groups_create_request]/filters/anyOf[#/components/schemas/CatalogsCreativeAssetsProductGroupFiltersAnyOf -> subschema #1: any_of]/any_of/items/anyOf[#/components/schemas/CustomLabel3Filter -> subschema #5: CUSTOM_LABEL_3]/CUSTOM_LABEL_3/filter_operator_type`
  - added the new optional request property `oneOf[subschema #2: catalog based]/oneOf[subschema #3: creative_assets_product_groups_create_request]/filters/anyOf[#/components/schemas/CatalogsCreativeAssetsProductGroupFiltersAnyOf -> subschema #1: any_of]/any_of/items/anyOf[#/components/schemas/CustomLabel4Filter -> subschema #6: CUSTOM_LABEL_4]/CUSTOM_LABEL_4/filter_operator_type`
  - added `#/components/schemas/TitleKeywordsFilter` to the `oneOf[subschema #2: catalog based]/oneOf[subschema #2: hotel_product_groups_create_request]/filters/anyOf[#/components/schemas/CatalogsHotelProductGroupFiltersAllOf -> subschema #2: all_of]/all_of/items/` request property `anyOf` list
  - added `#/components/schemas/TitleKeywordsFilter` to the `oneOf[subschema #2: catalog based]/oneOf[subschema #2: hotel_product_groups_create_request]/filters/anyOf[#/components/schemas/CatalogsHotelProductGroupFiltersAnyOf -> subschema #1: any_of]/any_of/items/` request property `anyOf` list
  - added `#/components/schemas/TitleKeywordsFilter` to the `oneOf[subschema #2: catalog based]/oneOf[subschema #3: creative_assets_product_groups_create_request]/filters/anyOf[#/components/schemas/CatalogsCreativeAssetsProductGroupFiltersAllOf -> subschema #2: all_of]/all_of/items/` request property `anyOf` list
  - added `#/components/schemas/TitleKeywordsFilter` to the `oneOf[subschema #2: catalog based]/oneOf[subschema #3: creative_assets_product_groups_create_request]/filters/anyOf[#/components/schemas/CatalogsCreativeAssetsProductGroupFiltersAnyOf -> subschema #1: any_of]/any_of/items/` request property `anyOf` list
  - added `subschema #1: any_of, subschema #2: all_of` to the `oneOf[subschema #1: retail feed based]/filters` request property `anyOf` list
  - added `subschema #1: any_of, subschema #2: all_of` to the `oneOf[subschema #2: catalog based]/oneOf[subschema #1: retail_product_groups_create_request]/filters` request property `anyOf` list
  - added the optional property `oneOf[subschema #1: retail_product_group]/filters/anyOf[#/components/schemas/CatalogsProductGroupFiltersAllOf -> subschema #2: all_of]/all_of/items/anyOf[#/components/schemas/CustomLabel0Filter -> subschema #8: CUSTOM_LABEL_0]/CUSTOM_LABEL_0/filter_operator_type` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: retail_product_group]/filters/anyOf[#/components/schemas/CatalogsProductGroupFiltersAllOf -> subschema #2: all_of]/all_of/items/anyOf[#/components/schemas/CustomLabel1Filter -> subschema #9: CUSTOM_LABEL_1]/CUSTOM_LABEL_1/filter_operator_type` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: retail_product_group]/filters/anyOf[#/components/schemas/CatalogsProductGroupFiltersAllOf -> subschema #2: all_of]/all_of/items/anyOf[#/components/schemas/CustomLabel2Filter -> subschema #10: CUSTOM_LABEL_2]/CUSTOM_LABEL_2/filter_operator_type` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: retail_product_group]/filters/anyOf[#/components/schemas/CatalogsProductGroupFiltersAllOf -> subschema #2: all_of]/all_of/items/anyOf[#/components/schemas/CustomLabel3Filter -> subschema #11: CUSTOM_LABEL_3]/CUSTOM_LABEL_3/filter_operator_type` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: retail_product_group]/filters/anyOf[#/components/schemas/CatalogsProductGroupFiltersAllOf -> subschema #2: all_of]/all_of/items/anyOf[#/components/schemas/CustomLabel4Filter -> subschema #12: CUSTOM_LABEL_4]/CUSTOM_LABEL_4/filter_operator_type` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: retail_product_group]/filters/anyOf[#/components/schemas/CatalogsProductGroupFiltersAnyOf -> subschema #1: any_of]/any_of/items/anyOf[#/components/schemas/CustomLabel0Filter -> subschema #8: CUSTOM_LABEL_0]/CUSTOM_LABEL_0/filter_operator_type` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: retail_product_group]/filters/anyOf[#/components/schemas/CatalogsProductGroupFiltersAnyOf -> subschema #1: any_of]/any_of/items/anyOf[#/components/schemas/CustomLabel1Filter -> subschema #9: CUSTOM_LABEL_1]/CUSTOM_LABEL_1/filter_operator_type` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: retail_product_group]/filters/anyOf[#/components/schemas/CatalogsProductGroupFiltersAnyOf -> subschema #1: any_of]/any_of/items/anyOf[#/components/schemas/CustomLabel2Filter -> subschema #10: CUSTOM_LABEL_2]/CUSTOM_LABEL_2/filter_operator_type` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: retail_product_group]/filters/anyOf[#/components/schemas/CatalogsProductGroupFiltersAnyOf -> subschema #1: any_of]/any_of/items/anyOf[#/components/schemas/CustomLabel3Filter -> subschema #11: CUSTOM_LABEL_3]/CUSTOM_LABEL_3/filter_operator_type` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: retail_product_group]/filters/anyOf[#/components/schemas/CatalogsProductGroupFiltersAnyOf -> subschema #1: any_of]/any_of/items/anyOf[#/components/schemas/CustomLabel4Filter -> subschema #12: CUSTOM_LABEL_4]/CUSTOM_LABEL_4/filter_operator_type` to the response with the `201` status
  - …28 more
- **2024-08-14** (v5) `89c27ed39cfd` — 2 breaking, 8 info
  - removed `subschema #1, subschema #2` from the `oneOf[subschema #1: retail feed based]/filters` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `oneOf[subschema #2: catalog based]/oneOf[subschema #1: retail_product_groups_create_request]/filters` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `oneOf[subschema #1: retail feed based]/filters` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `oneOf[subschema #2: catalog based]/oneOf[subschema #1: retail_product_groups_create_request]/filters` request property `anyOf` list
  - request property `oneOf[subschema #1: retail feed based]/is_featured` deprecated
  - added the optional property `oneOf[subschema #1: retail_product_group]/country` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: retail_product_group]/locale` to the response with the `201` status
  - added `#/components/schemas/MediaTypeFilter` to the `oneOf[subschema #1: retail_product_group]/filters/anyOf[#/components/schemas/CatalogsProductGroupFiltersAllOf]/all_of/items/` response property `anyOf` list for the response status `201`
  - added `#/components/schemas/MediaTypeFilter` to the `oneOf[subschema #1: retail_product_group]/filters/anyOf[#/components/schemas/CatalogsProductGroupFiltersAnyOf]/any_of/items/` response property `anyOf` list for the response status `201`
  - response property `oneOf[subschema #1: retail_product_group]/is_featured` deprecated
- **2024-04-23** (v5) `f9321315766f` — 3 breaking, 5 info
  - removed `subschema #1, subschema #2` from the `oneOf[subschema #1: retail -> subschema #1: retail feed based]/filters` request property `anyOf` list
  - added `#/components/schemas/CatalogsRetailProductGroup, #/components/schemas/CatalogsHotelProductGroup, #/components/schemas/CatalogsCreativeAssetsProductGroup` to the response body `oneOf` list for the response status `201`
  - the response's body type/format changed from ``/`` to `object`/`` for status `201`
  - added `subschema #1, subschema #2` to the `oneOf[subschema #1: retail -> subschema #1: retail feed based]/filters` request property `anyOf` list
  - added `RETAIL, CREATIVE_ASSETS` discriminator mapping keys to the `oneOf[subschema #2: hotel -> subschema #2: catalog based]/` request property
  - added `#/components/schemas/CatalogsRetailProductGroupCreateRequest, #/components/schemas/CatalogsCreativeAssetsProductGroupCreateRequest` to the `oneOf[subschema #2: hotel -> subschema #2: catalog based]/` request property `oneOf` list
  - added response discriminator for the response status `201`
  - removed `#/components/schemas/CatalogsProductGroup, #/components/schemas/CatalogsVerticalProductGroup` from the response body `oneOf` list for the response status `201`
- **2024-02-08** (v5) `7529b464d5cb` — 3 breaking, 2 info
  - the request's body type/format changed from `object`/`` to ``/``
  - added `#/components/schemas/CatalogsProductGroup, #/components/schemas/CatalogsVerticalProductGroup` to the response body `oneOf` list for the response status `201`
  - the response's body type/format changed from `object`/`` to ``/`` for status `201`
  - added `#/components/schemas/CatalogsVerticalProductGroupCreateRequest` to the request body `oneOf` list
  - removed `subschema #1: catalogs_product_group_feed_based_case, subschema #2: catalogs_product_group_merchant_based_case` from the response body `oneOf` list for the response status `201`
- **2023-07-14** (v5) `52586a274771` — 1 breaking, 12 warning, 1 info
  - removed `subschema #1, subschema #2` from the `oneOf[subschema #1: product_groups_create_request_feed_base_case]/filters` request property `anyOf` list
  - added the new `FEMALE` enum value to the `oneOf[subschema #1: catalogs_product_group_feed_based_case]/filters/anyOf[#/components/schemas/CatalogsProductGroupFiltersAllOf]/all_of/items/anyOf[#/components/schemas/GenderFilter]/GENDER/values/items/` response property for the response status `201`
  - added the new `FEMALE` enum value to the `oneOf[subschema #1: catalogs_product_group_feed_based_case]/filters/anyOf[#/components/schemas/CatalogsProductGroupFiltersAnyOf]/any_of/items/anyOf[#/components/schemas/GenderFilter]/GENDER/values/items/` response property for the response status `201`
  - added the new `FEMALE` enum value to the `oneOf[subschema #2: catalogs_product_group_merchant_based_case]/filters/anyOf[#/components/schemas/CatalogsProductGroupFiltersAllOf]/all_of/items/anyOf[#/components/schemas/GenderFilter]/GENDER/values/items/` response property for the response status `201`
  - added the new `FEMALE` enum value to the `oneOf[subschema #2: catalogs_product_group_merchant_based_case]/filters/anyOf[#/components/schemas/CatalogsProductGroupFiltersAnyOf]/any_of/items/anyOf[#/components/schemas/GenderFilter]/GENDER/values/items/` response property for the response status `201`
  - added the new `MALE` enum value to the `oneOf[subschema #1: catalogs_product_group_feed_based_case]/filters/anyOf[#/components/schemas/CatalogsProductGroupFiltersAllOf]/all_of/items/anyOf[#/components/schemas/GenderFilter]/GENDER/values/items/` response property for the response status `201`
  - added the new `MALE` enum value to the `oneOf[subschema #1: catalogs_product_group_feed_based_case]/filters/anyOf[#/components/schemas/CatalogsProductGroupFiltersAnyOf]/any_of/items/anyOf[#/components/schemas/GenderFilter]/GENDER/values/items/` response property for the response status `201`
  - added the new `MALE` enum value to the `oneOf[subschema #2: catalogs_product_group_merchant_based_case]/filters/anyOf[#/components/schemas/CatalogsProductGroupFiltersAllOf]/all_of/items/anyOf[#/components/schemas/GenderFilter]/GENDER/values/items/` response property for the response status `201`
  - added the new `MALE` enum value to the `oneOf[subschema #2: catalogs_product_group_merchant_based_case]/filters/anyOf[#/components/schemas/CatalogsProductGroupFiltersAnyOf]/any_of/items/anyOf[#/components/schemas/GenderFilter]/GENDER/values/items/` response property for the response status `201`
  - added the new `UNISEX` enum value to the `oneOf[subschema #1: catalogs_product_group_feed_based_case]/filters/anyOf[#/components/schemas/CatalogsProductGroupFiltersAllOf]/all_of/items/anyOf[#/components/schemas/GenderFilter]/GENDER/values/items/` response property for the response status `201`
  - added the new `UNISEX` enum value to the `oneOf[subschema #1: catalogs_product_group_feed_based_case]/filters/anyOf[#/components/schemas/CatalogsProductGroupFiltersAnyOf]/any_of/items/anyOf[#/components/schemas/GenderFilter]/GENDER/values/items/` response property for the response status `201`
  - added the new `UNISEX` enum value to the `oneOf[subschema #2: catalogs_product_group_merchant_based_case]/filters/anyOf[#/components/schemas/CatalogsProductGroupFiltersAllOf]/all_of/items/anyOf[#/components/schemas/GenderFilter]/GENDER/values/items/` response property for the response status `201`
  - added the new `UNISEX` enum value to the `oneOf[subschema #2: catalogs_product_group_merchant_based_case]/filters/anyOf[#/components/schemas/CatalogsProductGroupFiltersAnyOf]/any_of/items/anyOf[#/components/schemas/GenderFilter]/GENDER/values/items/` response property for the response status `201`
  - added `subschema #1, subschema #2` to the `oneOf[subschema #1: product_groups_create_request_feed_base_case]/filters` request property `anyOf` list
- **2022-11-14** (v5) `e041d7b0cef0` — 1 info
  - added the new optional `query` request parameter `ad_account_id`
- **2022-09-07** (v5) `bd20b6eb152f` — 4 warning
  - added the new `I2PC` enum value to the `oneOf[subschema #1: catalogs_product_group_feed_based_case]/type` response property for the response status `201`
  - added the new `I2PC` enum value to the `oneOf[subschema #2: catalogs_product_group_merchant_based_case]/type` response property for the response status `201`
  - added the new `SHOPIFY_COLLECTIONS` enum value to the `oneOf[subschema #1: catalogs_product_group_feed_based_case]/type` response property for the response status `201`
  - added the new `SHOPIFY_COLLECTIONS` enum value to the `oneOf[subschema #2: catalogs_product_group_merchant_based_case]/type` response property for the response status `201`
- **2022-07-11** (v5) `0d5998752011` — 2 breaking, 4 warning, 2 info
  - added `subschema #1: catalogs_product_group_feed_based_case, subschema #2: catalogs_product_group_merchant_based_case` to the response body `oneOf` list for the response status `201`
  - the response's body type/format changed from ``/`` to `object`/`` for status `201`
  - removed the request property `description`
  - removed the request property `feed_id`
  - removed the request property `filters`
  - removed the request property `name`
  - added `subschema #1: product_groups_create_request_feed_base_case` to the request body `oneOf` list
  - removed `subschema #1` from the response body `allOf` list for the response status `201`
- **2022-04-12** (v5) `723c51158044` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/catalogs/product_groups/post.md) · [API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) · [Page](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/catalogs/product_groups/post)
