---
title: "Post - Create a Catalog Ingestion Job (Beta)"
method: POST
path: "/catalog/ingestion"
tags: ["Catalog"]
---

# Post - Create a Catalog Ingestion Job (Beta)

`POST /catalog/ingestion`

<b>Seamlessly Integrate Catalog Data into Our Platform.</b><br>To create an ingestion job, you need to provide a set of catalog attributes. This API is asynchronous and will return an IngestionID that will require polling.

## Request body

- union
  - CatalogIngestionInput
    - `items` union[], required — An array of items associated with the ingestion job.
      - union
        - IngestionSneakersShoesRequestInput
          - `category` 'sneakers' | 'shoes' | 'apparel' | 'accessories' | 'collectibles' | 'electronics' | 'trading cards', required
          - `productTitle` string, required — A string that uniquely identifies the name of the product.
          - `brand` string, required — The brand of the product.
          - `productImages` string[], required — Public facing links to the products image.
          - `variants` string[], required — The product variants available to sell. For example, for sneakers, each different size is a different variant or for electronics like iPhone, each different storage capacity is a different variant.
          - `retailPrice` string, required — The products retail price.
          - `releaseDate` string, required — The products release date.
          - `countryOfOrigin` string, required — The country in which the product was manufactured in ISO Alpha 2 Format.
          - `partnerProductId` string — An external ID that partners will use to reference an internal StockX catalog item if approved. Note that this is the higher level product id, not the variantId.
          - `tags` string[] — A list of attributes or short descriptors associated with the product.
          - `colorway` string, required — The combinations of colors in which the product is designed. Ex VIOLET ORE/MEDIUM ASH-BLACK-MUSLIN-BURGUNDY CRUSH.
          - `gtin` string, required — The products global trade item number. Length must be 8, 12, 13, 14 or 18.
          - `gender` string, required — The products targeted gender.
          - `styleCode` string, required — The Style Code for the product @example "M990BK5"
          - `productDescription` string — Open text field used for describing the product to the customer.
          - `dimensions` string — A string of the dimensions of the product. @example "2/"x4/"x6/""
          - `weight` string — The weight of the product.
          - `material` string — Brand listed materials.
          - `productURL` string — Official third party product URL.
        - IngestionApparelAccessoriesRequestInput
          - `category` 'sneakers' | 'shoes' | 'apparel' | 'accessories' | 'collectibles' | 'electronics' | 'trading cards', required
          - `productTitle` string, required — A string that uniquely identifies the name of the product.
          - `brand` string, required — The brand of the product.
          - `productImages` string[], required — Public facing links to the products image.
          - `variants` string[], required — The product variants available to sell. For example, for sneakers, each different size is a different variant or for electronics like iPhone, each different storage capacity is a different variant.
          - `retailPrice` string, required — The products retail price.
          - `releaseDate` string, required — The products release date.
          - `countryOfOrigin` string, required — The country in which the product was manufactured in ISO Alpha 2 Format.
          - `partnerProductId` string — An external ID that partners will use to reference an internal StockX catalog item if approved. Note that this is the higher level product id, not the variantId.
          - `tags` string[] — A list of attributes or short descriptors associated with the product.
          - `colorway` string, required — The combinations of colors in which the product is designed.
          - `material` string, required — Brand listed materials.
          - `gender` string, required — The products targeted gender.
          - `styleCode` string — The Style Code for the product @example "M990BK5"
          - `gtin` string — The products global trade item number.
          - `productDescription` string — Open text field used for describing the product to the customer.
          - `dimensions` string — A string of the dimensions of the product.
          - `weight` string — The weight of the product.
          - `productURL` string — Official third party product URL.
          - `productCode` ProductCode
            - `code` string, required — Unique code that identifies the product.
            - `name` 'serial number' | 'mpn', required
        - IngestionCollectiblesRequestInput
          - `category` 'sneakers' | 'shoes' | 'apparel' | 'accessories' | 'collectibles' | 'electronics' | 'trading cards', required
          - `productTitle` string, required — A string that uniquely identifies the name of the product.
          - `brand` string, required — The brand of the product.
          - `productImages` string[], required — Public facing links to the products image.
          - `variants` string[], required — The product variants available to sell. For example, for sneakers, each different size is a different variant or for electronics like iPhone, each different storage capacity is a different variant.
          - `retailPrice` string, required — The products retail price.
          - `releaseDate` string, required — The products release date.
          - `countryOfOrigin` string, required — The country in which the product was manufactured in ISO Alpha 2 Format.
          - `partnerProductId` string — An external ID that partners will use to reference an internal StockX catalog item if approved. Note that this is the higher level product id, not the variantId.
          - `tags` string[] — A list of attributes or short descriptors associated with the product.
          - `colorway` string — The combinations of colors in which the product is designed.
          - `styleCode` string — The Style Code for the product @example "M990BK5"
          - `productDescription` string — Open text field used for describing the product to the customer.
          - `dimensions` string — A string of the dimensions of the product.
          - `weight` string — The weight of the product.
          - `productURL` string — Official third party product URL.
          - `productCode` ProductCode
            - `code` string, required — Unique code that identifies the product.
            - `name` 'serial number' | 'mpn', required
        - IngestionElectronicsRequestInput
          - `category` 'sneakers' | 'shoes' | 'apparel' | 'accessories' | 'collectibles' | 'electronics' | 'trading cards', required
          - `productTitle` string, required — A string that uniquely identifies the name of the product.
          - `brand` string, required — The brand of the product.
          - `productImages` string[], required — Public facing links to the products image.
          - `variants` string[], required — The product variants available to sell. For example, for sneakers, each different size is a different variant or for electronics like iPhone, each different storage capacity is a different variant.
          - `retailPrice` string, required — The products retail price.
          - `releaseDate` string, required — The products release date.
          - `countryOfOrigin` string, required — The country in which the product was manufactured in ISO Alpha 2 Format.
          - `partnerProductId` string — An external ID that partners will use to reference an internal StockX catalog item if approved. Note that this is the higher level product id, not the variantId.
          - `tags` string[] — A list of attributes or short descriptors associated with the product.
          - `colorway` string — The combinations of colors in which the product is designed.
          - `styleCode` string — The Style Code for the product @example "M990BK5"
          - `gtin` string — The products global trade item number.
          - `productDescription` string — Open text field used for describing the product to the customer.
          - `dimensions` string — A string of the dimensions of the product.
          - `weight` string — The weight of the product.
          - `productURL` string — Official third party product URL.
          - `productCode` ProductCode
            - `code` string, required — Unique code that identifies the product.
            - `name` 'serial number' | 'mpn', required
        - IngestionTradingCardsRequestInput
          - `category` 'sneakers' | 'shoes' | 'apparel' | 'accessories' | 'collectibles' | 'electronics' | 'trading cards', required
          - `productTitle` string, required — A string that uniquely identifies the name of the product.
          - `brand` string, required — The brand of the product.
          - `productImages` string[], required — Public facing links to the products image.
          - `variants` string[], required — The product variants available to sell. For example, for sneakers, each different size is a different variant or for electronics like iPhone, each different storage capacity is a different variant.
          - `retailPrice` string, required — The products retail price.
          - `releaseDate` string, required — The products release date.
          - `countryOfOrigin` string, required — The country in which the product was manufactured in ISO Alpha 2 Format.
          - `partnerProductId` string — An external ID that partners will use to reference an internal StockX catalog item if approved. Note that this is the higher level product id, not the variantId.
          - `tags` string[] — A list of attributes or short descriptors associated with the product.
          - `colorway` string — The combinations of colors in which the product is designed.
          - `styleCode` string — The Style Code for the product @example "M990BK5"
          - `gtin` string — The products global trade item number.
          - `productDescription` string — Open text field used for describing the product to the customer.
          - `dimensions` string — A string of the dimensions of the product.
          - `weight` string — The weight of the product.
          - `productURL` string — Official third party product URL.
          - `productCode` ProductCode
            - `code` string, required — Unique code that identifies the product.
            - `name` 'serial number' | 'mpn', required
  - unknown

## Response `201`

Created

- IngestionControllerResponse
  - `ingestionId` string, required — Unique ID used to return the status of an ingestion job.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/stockx/apis/stockx-public-api.md) · [All operations](https://skmtc.net/stockx/apis/stockx-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stockx/stockx-public-api/versions/5b4ba84182d7/schema)