---
title: "POST /products"
method: POST
path: "/products"
tags: ["Products"]
---

# POST /products

`POST /products`

Creates a new product

## Request body

- CreateProductRequest — Request body for creating a product
  - `code` string, required — Product code (unique identifier)
  - `description` string, required — Description of the product
  - `seller` union, required — Seller information
    - PlatformSeller
      - `soldByPlatform` true, required — Indicates the product is sold by the platform
    - CounterpartySeller
      - `soldByPlatform` false, required — Indicates the product is sold by a counterparty
      - `counterpartyType` string, required — Type of the counterparty seller

## Response `201`

Success

- ProductSuccessResponse
  - `data` Product, required — Product object
    - `workspaceId` string, required — Workspace ID this product belongs to
    - `code` string, required — Product code (unique identifier)
    - `description` string, required — Description of the product
    - `seller` union, required — Seller information
      - PlatformSeller
        - `soldByPlatform` true, required — Indicates the product is sold by the platform
      - CounterpartySeller
        - `soldByPlatform` false, required — Indicates the product is sold by a counterparty
        - `counterpartyType` string, required — Type of the counterparty seller
    - `updateVersion` number, required — Version number for optimistic locking
    - `created` string, date-time, required — ISO 8601 timestamp when the product was created

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `500` — Internal server error

## Changes

- **2026-01-27** `ec5eb2a41457` — 2 info
  - the endpoint scheme security `oauth2` was added to the API
  - the endpoint scheme security `Bearer` was removed from the API

[Change history](https://skmtc.dev/fragment-dev/apis/fragment-payments-api/changes/products/post.md)

---

[API](https://skmtc.dev/fragment-dev/apis/fragment-payments-api.md) · [All operations](https://skmtc.dev/fragment-dev/apis/fragment-payments-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fragment-dev/apis/fragment-payments-api/revisions/02f5100e40d0?raw)