---
title: "Create item"
method: POST
path: "/catalogues/items"
tags: ["Catalogues"]
---

# Create item

`POST /catalogues/items`

Create an item either as standalone or directly in a catalogue.

## Request body

- object — Schema for creating a catalogue item.
  - `sku` string — Product SKU (optional - auto-generated if not provided)
  - `name` string, required — Product name
  - `description` string — Product description (optional)
  - `price` string — Product price (optional)
  - `currency` string — Currency code (optional)
  - `quantity` integer — Available quantity (optional)
  - `category` string — Product category (optional)
  - `catalogue_id` string, uuid, nullable — Catalogue ID to add the item to (optional - creates standalone if not provided)

## Response `201`

Item created successfully

- object
  - `ok` boolean
  - `data` object
    - `id` string, uuid
    - `catalogue_id` string, uuid, nullable
    - `sku` string, nullable
    - `name` string
    - `description` string, nullable
    - `price` string, nullable
    - `currency` string, nullable
    - `quantity` integer, nullable
    - `category` string, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `400` — Invalid request data
- `401` — Invalid or missing API key
- `403` — Insufficient permissions

---

[API](https://skmtc.net/yourang/apis/yourang-ai-external-api-v1.md) · [All operations](https://skmtc.net/yourang/apis/yourang-ai-external-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yourang/yourang-ai-external-api-v1/versions/49680ee64400/schema)