Sign in

v29

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-06-042661,1122.5 MB
catalog_feeds

Create feed

Create a new feed owned by the "operation user_account".

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

Please, be aware that "default_country" and "default_locale" are not required in the spec for forward compatibility but for now the API will not accept requests without those fields.

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.

For Retail partners, refer to Before you get started with Catalogs. For Hotel partners, refer to Pinterest API for shopping.

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/feeds

Query parameters

ad_account_idstring

Unique identifier of an ad account.

Request body

OR

Response

The request has succeeded.

OR
OR

Example response

{
  "id": "864344156814050986"
}