ad_accounts14

ad_groups13

ads10

advanced_auction2

audience_insights2

audience_sharing7

audiences4

billing11

boards11

bulk3

business_access_assets12

business_access_invite6

business_access_relationships9

campaigns8

catalog_feeds8

catalog_items3

catalog_product_groups10

catalog_reports3

catalog_supplemental7

catalogs3

conversion_deletion_requests4

conversion_eqs1

conversion_events1

conversion_tags5

conversions4

customer_list_uploads3

customer_lists4

customer_segment3

integrations7

keywords5

labels5

lead_ads4

lead_forms5

leads_export2

media3

msot_events1

notification1

oauth3

order_lines2

pins8

product_group_promotions5

product_tags3

promotions5

resources6

schedules3

search3

targeting_template3

terms2

terms_of_service1

trends4

user_account14

catalog_product_groups

Create product group

Changed on Jun 4, 2026

Create product group to use in Catalogs owned by the "operation user_account".

By default, the "operation user_account" is the token user_account.

Optional: Business Access: Specify an ad_account_id (obtained via List ad accounts) to use the owner of that ad_account as the "operation user_account". In order to do this, the token user_account must have one of the following Business Access roles on the ad_account: Owner, Admin, Catalogs Manager. "Catalog-based product groups" can include items from all data sources (feeds and API) and are available to both non-retail catalogs with any data sources and retail catalogs with API-created items. If your catalog only contains retail items created via feeds, you should use the "retail feed-based" option. Learn more

Note: Access to the Creative Assets catalog type is restricted to a specific group of users. If you require access, please reach out to your partner manager.

post/catalogs/product_groups

Request

Base URL
https://api.pinterest.com/v5
Auth
OAuth 2
Authorization codehttps://www.pinterest.com/oauth/
Token URLhttps://api.pinterest.com/v5/oauth/token
Scopescatalogs:write
TypeScript
https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/catalogs/product_groups/post.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

ad_account_idstring

Unique identifier of an ad account.

Request body

Response

The request has succeeded.

Changes

Jun 4, 2026v5b698c180678a Revision changes
- breaking
  added to the // request property allOf list
- breaking
  added to the // request property allOf list
- breaking
  added to the // request property allOf list
- breaking
  removed subschema #1: any_of subschema #2: all_of from the / request property anyOf list
- breaking
  removed subschema #1: any_of subschema #2: all_of from the // request property anyOf list
- breaking
  the / request property type changed from object to no type
- breaking
  the // request property type changed from string to no type
- breaking
  the // request property type changed from object to no type
- breaking
  the // request property type changed from string to no type
- breaking
  the // request property type changed from object to no type
- breaking
  the ///// request property type changed from object to no type
- breaking
  the ///// request property type changed from object to no type
- breaking
  the // request property type changed from string to no type
- breaking
  the // request property type changed from object to no type
- breaking
  the ///// request property type changed from object to no type
- breaking
  the ///// request property type changed from object to no type
- breaking
  the / response's property type changed from string to no type for status
- breaking
  the / response's property type changed from object to no type for status
- breaking
  the //// response's property type changed from object to no type for status
- breaking
  the //// response's property type changed from object to no type for status
- breaking
  the / response's property type changed from string to no type for status
- breaking
  the / response's property type changed from string to no type for status
- breaking
  the / response's property type changed from object to no type for status
- breaking
  the //// response's property type changed from object to no type for status
- breaking
  the //// response's property type changed from object to no type for status
- breaking
  the / response's property type changed from string to no type for status
- breaking
  the / response's property type changed from string to no type for status
- breaking
  the / response's property type changed from object to no type for status
- breaking
  the //// response's property type changed from object to no type for status
- breaking
  the //// response's property type changed from object to no type for status
- breaking
  the / response's property type changed from string to no type for status
- warning
  added the new CATALOG_EXPANSION enum value to the / response property for the response status
- info
  added to the / request property anyOf list
- info
  added to the // request property anyOf list
- info
  added to the ///// request property anyOf list
- info
  added to the ///// request property anyOf list
- info
  the request property default value IS was removed
- info
  the request property default value IS was removed
- info
  the request property default value IS was removed
- info
  the request property default value IS was removed
- info
  the request property default value IS was removed
- info
  the request property default value IS was removed
- info
  the request property default value IS was removed
- info
  the request property default value IS was removed
- info
  the request property default value IS was removed
- info
  the request property default value IS was removed
- info
  the request property default value IS was removed
- info
  the request property default value IS was removed
- info
  the request property default value IS was removed
- info
  the request property default value IS was removed
- info
  the request property default value IS was removed
- info
  the request property default value IS was removed
- info
  the request property default value IS was removed
- info
  the request property default value IS was removed
- info
  the request property default value IS was removed
- info
  the request property default value IS was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  the request property default value false was removed
- info
  removed the pattern ^\d+$ from the request property //
- info
  removed the pattern ^\d+$ from the request property //
- info
  removed the pattern ^\d+$ from the request property //
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  removed the non-success response with the status
- info
  added to the / response property allOf list for the response status
- info
  added to the / response property allOf list for the response status
- info
  added to the / response property allOf list for the response status
- info
  added to the / response property allOf list for the response status
- info
  added to the / response property allOf list for the response status
- info
  added to the / response property allOf list for the response status
- info
  added to the //// response property anyOf list for the response status
- info
  added to the //// response property anyOf list for the response status
- info
  added to the //// response property anyOf list for the response status
- info
  added to the //// response property anyOf list for the response status
- info
  removed from the //// response property anyOf list for the response status
- info
  removed from the //// response property anyOf list for the response status
- info
  the response's property default value IS was removed for the status
- info
  the response's property default value IS was removed for the status
- info
  the response's property default value IS was removed for the status
- info
  the response's property default value IS was removed for the status
- info
  the response's property default value IS was removed for the status
- info
  the response's property default value IS was removed for the status
- info
  the response's property default value IS was removed for the status
- info
  the response's property default value IS was removed for the status
- info
  the response's property default value IS was removed for the status
- info
  the response's property default value IS was removed for the status
- info
  the response's property default value IS was removed for the status
- info
  the response's property default value IS was removed for the status
- info
  the response's property default value IS was removed for the status
- info
  the response's property default value IS was removed for the status
- info
  the response's property default value IS was removed for the status
- info
  the response's property default value IS was removed for the status
- info
  the response's property default value IS was removed for the status
- info
  the response's property default value IS was removed for the status
- info
  the response's property default value IS was removed for the status
- info
  the response's property default value IS was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the / response's property pattern ^\d+$ was removed for the status
- info
  the / response's property pattern ^\d+$ was removed for the status
- info
  the / response's property pattern ^\d+$ was removed for the status
- info
  the / response's property pattern ^\d+$ was removed for the status
- info
  the / response's property pattern ^\d+$ was removed for the status
- info
  the / response's property pattern ^\d+$ was removed for the status
- info
  added the success response with the status
Jul 16, 2025v543134ca41f18 Revision changes
- info
  the request property // became optional
- info
  the request property // became optional

Operation history (11 revisions)