---
title: "/2026-01/retail-media/accounts/{accountId}/catalogs"
method: POST
path: "/2026-01/retail-media/accounts/{accountId}/catalogs"
tags: ["Campaign"]
---

# /2026-01/retail-media/accounts/{accountId}/catalogs

`POST /2026-01/retail-media/accounts/{accountId}/catalogs`

Create a request for a Catalog available to the indicated account.

## Path parameters

- `accountId` string, required

## Request body

- JsonApiRequestOfCatalogRequest — A JSON:API wrapper class to format a <typeparamref name="TAttributes" /> with Type, and Attributes properties
  - `data` JsonApiBodyWithoutIdOfCatalogRequestAndCatalogRequest — A JSON:API wrapper class to format a <typeparamref name="TAttributes" /> with Type, and Attributes properties
    - `attributes` ExternalCatalogRequest — A request for a catalog under the specified format. Currently "json-newline" is supported.
      - `brandIdFilter` string[], nullable
      - `format` 'unknown' | 'json-newline' — An enumeration of Catalog formats
    - `type` string, required

## Response `200`

Catalog request successfully created

- JsonApiSingleResponseOfCatalogStatus — A JSON:API wrapper class to add one JSON:API <typeparamref name="T" /> within a data property
  - `data` JsonApiBodyWithIdOfInt64AndCatalogStatusAndCatalogStatus, required — A JSON:API wrapper class to format a <typeparamref name="TAttributes" /> with external Id, Type, and Attributes properties
    - `attributes` ExternalCatalogStatus, nullable — The status of an asynchronous request to generate a catalog
      - `createdAt` string, date-time, required — The time this catalog was created. Represented as a UTC ISO8601 string.
      - `currency` string, nullable, required — An ISO4217 representation of the currency products are listed under in this catalog.
      - `fileSizeBytes` integer, nullable, required — The size of this catalog in bytes. Available when this catalog reaches a success status.
      - `md5Checksum` string, nullable, required — An MD5 checksum of the catalog for use in confirming complete and uncorrupted retrieval. Available when this catalog reaches a success status.
      - `message` string, nullable, required — An optional information message intended for developer consumption.
      - `rowCount` integer, nullable, required — An indication of the number of products contained in this catalog. Available when this catalog reaches a success status.
      - `status` 'unknown' | 'pending' | 'success' | 'failure' | 'expired', required — An enumeration of the status of the catalog.
    - `id` string, long-id, required
    - `type` string, required
  - `errors` CommonError[], nullable
    - `code` string, nullable — (REQUIRED) A machine-readable unique error code, expressed as a string value. The format used must be kebab-case.
    - `detail` string, nullable — (RECOMMENDED) A human-readable explanation specific to this occurrence of the problem.
    - `instance` string, nullable — (REQUIRED) A URI reference that identifies the specific occurrence of the problem.
    - `source` object, nullable — (OPTIONAL) A machine-readable structure to reference to the exact location(s) causing the error(s)
    - `stackTrace` string, nullable — (NEVER IN PRODUCTION) A human-readable stacktrace produced by the implementation technology
    - `title` string, nullable — (RECOMMENDED) A short, human-readable summary of the problem type.
    - `traceId` string, nullable — (REQUIRED) The Correlation ID provided by the Gateway. It is also a unique identifier for this particular occurrence of the problem.
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable — (REQUIRED) The classification of the error.
  - `warnings` CommonWarning[], nullable
    - `code` string, nullable — (REQUIRED) A machine-readable unique error code, expressed as a string value. The format used must be kebab-case.
    - `detail` string, nullable — (RECOMMENDED) A human-readable explanation specific to this occurrence of the problem.
    - `instance` string, nullable — (REQUIRED) A URI reference that identifies the specific occurrence of the problem.
    - `source` object, nullable — (OPTIONAL) A machine-readable structure to reference to the exact location(s) causing the error(s)
    - `stackTrace` string, nullable — (NEVER IN PRODUCTION) A human-readable stacktrace produced by the implementation technology
    - `title` string, nullable — (RECOMMENDED) A short, human-readable summary of the problem type.
    - `traceId` string, nullable — (REQUIRED) The Correlation ID provided by the Gateway. It is also a unique identifier for this particular occurrence of the problem.
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable — (REQUIRED) The classification of the error.

---

[API](https://skmtc.net/criteo/apis/criteo-api.md) · [All operations](https://skmtc.net/criteo/apis/criteo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/criteo/criteo-api/revisions/c1721589426a/schema)