---
title: "Bulk create catalog items"
method: POST
path: "/api/catalogs/{catalogName}/items"
tags: ["catalogs"]
---

# Bulk create catalog items

`POST /api/catalogs/{catalogName}/items`

Asynchronous. Create up to 1000 catalog items with a single request. Each of a catalog's items must have a unique ID that contains only alphanumeric characters and dashes and has a maximum length of 255 characters. If the catalog already contains an item with the same ID as one provided in the request body, the item in the catalog will be completely overwritten, unless replaceUploadedFieldsOnly is set to true. Do not use periods in field names.<br/><br/><b>Rate limit</b>: 100 requests/second, per API key.

## Path parameters

- `catalogName` string, required

## Request body

- CatalogBulkUploadRequest
  - `documents` object, required — Json map of id to values. Max number of pairs in list is 1000. Max size of each json value is is 30kb.
  - `replaceUploadedFieldsOnly` boolean, required — Whether to replace only the upload fields within each document, not each entire document

## Response `200`

successful operation

## Other responses

- `202` — Request to bulk upload items received
- `400` — Invalid parameters
- `401` — Invalid API key
- `404` — Catalog not found
- `500` — Internal server error

---

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