---
title: "Create a new product"
method: POST
path: "/v3/products"
tags: ["Products"]
---

# Create a new product

`POST /v3/products`

## Request body

- CreateProductV3Dto
  - `name` string, required — Internal catalog name of the product
  - `displayName` string — Customer-facing display name. If omitted, defaults to `name`.
  - `status` 'ACTIVE' | 'INACTIVE', required — Product status (active or inactive)
  - `description` string — Product description
  - `integrationItemId` string — ERP integration item ID
  - `erpClassId` string — ERP class ID

## Response `201`

Product created successfully

- object
  - `payload` object, required — Response payload, will be empty when success is false
    - `id` string, required — Product ID
    - `manufacturerId` string, required — Merchant ID
    - `name` string, required — Internal catalog name of the product
    - `displayName` string, required — Customer-facing display name of the product
    - `status` 'ACTIVE' | 'INACTIVE', required — Product status (active or inactive)
    - `createdAt` string, date-time, required — Product creation date
    - `updatedAt` string, date-time, nullable, required — Product last updated date
    - `description` string, nullable — Product description
    - `integrationItemId` string — ERP integration item ID
    - `integrationItemName` string, nullable — ERP integration item name
    - `erpClassId` string — ERP class ID
    - `erpClassName` string, nullable — ERP class name
  - `success` boolean, required — Boolean with true=success, false=failure
  - `message` string, required — Plain-text description of the result
  - `error` IntegratorsApiError, required
    - `code` number, required — API response code
    - `message` string, required — API response message
    - `details` object — Additional details about the error

## Other responses

- `400` — Bad Request - validation failed
- `404` — Merchant not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/tabsplatform/apis/tabs-external-api.md) · [All operations](https://skmtc.net/tabsplatform/apis/tabs-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tabsplatform/tabs-external-api/revisions/7e8885517814/schema)