v2

latestOpenAPI 3.1.02026-08-07750280.6 KB

Catalogues

Create item

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

post/catalogues/items

Request body

skustring

Product SKU (optional - auto-generated if not provided)

namestring required

Product name

descriptionstring

Product description (optional)

pricestring

Product price (optional)

currencystring

Currency code (optional)

quantityinteger

Available quantity (optional)

categorystring

Product category (optional)

catalogue_idstring uuid nullable

Catalogue ID to add the item to (optional - creates standalone if not provided)

Example request

{
  "catalogue_id": "123e4567-e89b-12d3-a456-426614174000",
  "category": "Widgets",
  "currency": "EUR",
  "description": "High-quality widget for professional use",
  "ignore_stock": false,
  "is_available": true,
  "name": "Premium Widget",
  "price": "29.99",
  "quantity": 100,
  "sku": "PROD-001"
}

Response

Item created successfully

okboolean