---
title: "Bulk Create Menu Items"
method: POST
path: "/merchant/{merchantReference}/menu/bulk-upload"
tags: ["Menu"]
---

# Bulk Create Menu Items

`POST /merchant/{merchantReference}/menu/bulk-upload`

Upload multiple menu items at once for a merchant. Accepts an array of item objects, each with name, price, category, and other details.

## Path parameters

- `merchantReference` string, required

## Request body

- object
  - `items` object[], required — Item information
    - `reference` string, required — A unique identifier for the menu item.
    - `name` string, required — The name of the menu item.
    - `price` number, double, required — The price of the menu item in the smallest currency unit (e.g., cents)
    - `description` string — description of the menu item
    - `images` object[] — An array of image objects
      - `path` string — image url
    - `category` object, required — An object representing the category of the item
      - `name` string, required — The name of the category
      - `rank` integer — The display rank of the category
      - `reference` string, required — A unique identifier for the category.
    - `in_stock` boolean, required — Indicates whether the item is currently in stock.
    - `modifiers` object[] — An array for any modifiers related to the menu item.
      - `name` string, required — The name of the modifier
      - `minimum_selection` integer — Minimum number of modifier selection
      - `maximum_selection` string — Maximum number of modifier selection
      - `items` object[], required — Items that make up modifier
        - `name` string, required — name of modifier item
        - `price` integer — price of modifier item
        - `reference` string — unique reference of modifier item

## Response `200`

---

[API](https://skmtc.dev/chowdeck/apis/chowdeck-api.md) · [All operations](https://skmtc.dev/chowdeck/apis/chowdeck-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chowdeck/chowdeck-api/revisions/5830cc8467d8/schema)
