---
title: "insert catalog item as bulk"
method: POST
path: "/catalog-items"
tags: ["Catalog Item"]
---

# insert catalog item as bulk

`POST /catalog-items`

## Request

- Base URL: `http://localhost`
- URL: `http://localhost/catalog-items`
- Auth: OAuth 2
  - Authorization code: `https://localhost/oauth2/authorize`
  - Token URL: `https://localhost/oauth2/authorize`

insert catalog item as bulk in inventory

## Request body

- BulkCatalogProcessingRequest: Insert catalog item for a specific partner.
  - `catalogItemList` BulkCatalogItem[], required: List of supplied items.
    - `sku` string: Stock keeping units(IDs) in third party inventory platform
    - `name` string: Catalog item name
    - `type` 'INGREDIENT' | 'PACKAGING': Catalog item type
    - `minLevel` StockLevel: Quantity details of a catalog item.
      - `level` integer: The amount or number of a specific catalog item
      - `unitId` string: Measuring unit id for above quantity
    - `purchaseUnit` Unit: The measuring unit
      - `id` string: Measuring unit id for purchasing a catalog item
    - `consumptionRatioInfoList` ConsumptionRatioInfoForBulkUpload[]
      - `consumptionUnit` Unit: The measuring unit
        - `id` string: Measuring unit id for purchasing a catalog item
      - `ratio` integer: Consumption ratio of a catalog item

## Response `200`

Successful response

- BulkCatalogProcessingJob: Insert bulk catalog item response
  - `jobId` string: Catalog processing job id in GrubTech platform
  - `createdAt` string, date-time: Catalog processing job creation time in GrubTech platform
  - `message` string: Error message

## Other responses

- `400`: Bad request
- `500`: Internal server error

---

[API](https://skmtc.dev/grubtech/apis/inventory-service.md) - [All operations](https://skmtc.dev/grubtech/apis/inventory-service/llms.txt) - [OpenAPI document](https://skmtc.dev/grubtech/apis/inventory-service/revisions/8e275e5431a4?raw)
