---
title: "Create a merchant item"
method: POST
path: "/api/public/v1/merchants/{merchant_reference}/items"
tags: ["Product Catalogue"]
---

# Create a merchant item

`POST /api/public/v1/merchants/{merchant_reference}/items`

## Request

- Base URL: `http://localhost:3009`
- URL: `http://localhost:3009/api/public/v1/merchants/{merchant_reference}/items`
- Auth: HTTP basic

Create a new item in the merchant's catalogue

## Path parameters

- `merchant_reference` string, required

## Headers

- `Authorization` string, required

## Request body

- MerchantItem
  - `id` string, required
  - `reference` string, required
  - `name` string, required
  - `category` string
  - `description` string
  - `price_with_tax` PrintableCurrency, required
    - `value` integer, required
    - `string` string, required
  - `subscription_price` PrintableCurrency
    - `value` integer, required
    - `string` string, required
  - `subscription_vat_rate` PrintableCurrency
    - `value` integer, required
    - `string` string, required
  - `subscription_period` string, nullable
  - `image_urls` unknown[]
    - unknown

## Response `201`

created

- object
  - `id` string, required
  - `reference` string, required
  - `name` string, required
  - `category` string
  - `description` string
  - `price_with_tax` PrintableCurrency, required
    - `value` integer, required
    - `string` string, required
  - `subscription_price` PrintableCurrency
    - `value` integer, required
    - `string` string, required
  - `subscription_vat_rate` PrintableCurrency
    - `value` integer, required
    - `string` string, required
  - `subscription_period` string, nullable
  - `image_urls` unknown[]
    - unknown

## Other responses

- `401`: unauthorized

---

[API](https://skmtc.dev/sequra/apis/instore-api.md) - [All operations](https://skmtc.dev/sequra/apis/instore-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sequra/apis/instore-api/revisions/29430b803abc?raw)