> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nocnoc/llms.txt
> Use this file to discover all available pages before exploring further.

# Create product

> Creates a new product and adds it to your catalog. Requires full product data.

<Note>Requests go to the live environment — all actions are real.</Note>

<Note>
  If you have an Amazon ASIN, use [Create product by ASIN](/api/api-reference/products/create-product-asin) instead — it auto-populates product data automatically.
</Note>

## Authorization

<ParamField header="X-Api-Key" type="string" required>
  Your seller API key. Provided by your nocnoc account manager.
</ParamField>

## Body parameters

<ParamField body="sku" type="string" required>
  Alphanumeric unique code for the product. Between 1 and 45 characters.
</ParamField>

<ParamField body="brand" type="string" required>
  Brand of the product. Between 1 and 45 characters.
</ParamField>

<ParamField body="available_quantity" type="integer" required>
  Stock quantity. Between 0 and 9999.
</ParamField>

<ParamField body="price" type="number" required>
  Price of the product. Up to 10 integer digits and 2 decimal places.
</ParamField>

<ParamField body="currency_code" type="string" required>
  Currency code (ISO). Currently only `USD` is supported.
</ParamField>

<ParamField body="title" type="string" required>
  Product title to be published.
</ParamField>

<ParamField body="description" type="string" required>
  Product description to be published.
</ParamField>

<ParamField body="description_language" type="string" required>
  Language of the description. Currently only `en` is supported.
</ParamField>

<ParamField body="condition" type="string">
  Product condition. One of: `NEW`, `USED`, `OPEN_BOX`, `REFURBISHED_A`, `REFURBISHED_B`, `REFURBISHED_C`, `REFURBISHED_D`. Defaults to `NEW`.
</ParamField>

<ParamField body="package_dimensions" type="object" required>
  Dimensions of the package. Contains `size` (object with `unit`, `length`, `width`, `height`) and `weight` (object with `unit`, `value`). Size units: `cm`, `inch`, `inches`, `mm`. Weight units: `kg`, `lb`, `gram`, `kilogram`, `pound`.
</ParamField>

<ParamField body="product_dimensions" type="object" required>
  Dimensions of the product itself. Same structure as `package_dimensions`.
</ParamField>

<ParamField body="images" type="array" required>
  Array of image objects, each with a `source_url` field. Minimum 1, maximum 10.
</ParamField>

<ParamField body="international_ids" type="object">
  International identifiers. Contains `gtin` (array of strings — Global Trade Item Number, e.g. EAN, UPC).
</ParamField>

<ParamField body="attributes" type="array">
  Additional product attributes. Each object has `type` (one of: `COLOR`, `SIZE`) and `value` (string).
</ParamField>

## Returns

The created product object with all submitted fields confirmed.

## Example request

```bash theme={null}
curl -X POST https://live.nocnocstore.com/api/v2/products \
  -H "X-Api-Key: YOUR_SELLER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sku": "SKU-001",
    "international_ids": { "gtin": ["4901234567890"] },
    "brand": "BRAND",
    "available_quantity": 20,
    "price": 23,
    "currency_code": "USD",
    "package_dimensions": {
      "size": { "unit": "cm", "length": 46, "width": 28, "height": 15 },
      "weight": { "unit": "kg", "value": 3 }
    },
    "product_dimensions": {
      "size": { "unit": "cm", "length": 42, "width": 26, "height": 13 },
      "weight": { "unit": "kg", "value": 2 }
    },
    "images": [{ "source_url": "https://example.com/image.jpg" }],
    "condition": "NEW",
    "title": "Product Title",
    "description_language": "en",
    "description": "Product description",
    "attributes": [
      { "type": "COLOR", "value": "Red" },
      { "type": "SIZE", "value": "Large" }
    ]
  }'
```

<ResponseExample>
  ```json 201 theme={null}
  {
    "sku": "SKU-001",
    "brand": "BRAND",
    "available_quantity": 20,
    "price": 23,
    "currency_code": "USD",
    "package_dimensions": {
      "size": { "unit": "cm", "width": 28, "height": 15, "length": 46 },
      "weight": { "value": 3, "unit": "kg" }
    },
    "product_dimensions": {
      "size": { "unit": "cm", "width": 26, "height": 13, "length": 42 },
      "weight": { "value": 2, "unit": "kg" }
    },
    "images": [{ "source_url": "https://example.com/image.jpg" }],
    "condition": "NEW",
    "title": "Product Title",
    "description_language": "en",
    "description": "Product description",
    "attributes": [
      { "type": "COLOR", "value": "Red" },
      { "type": "SIZE", "value": "Large" }
    ]
  }
  ```

  ```json 400 theme={null}
  {
    "code": 400,
    "message": "Invalid Request Payload.",
    "errors": [
      "Sku should be between 1 character minimum and 45 characters maximum.",
      "Brand should be between 1 character minimum and 45 characters maximum."
    ]
  }
  ```

  ```json 400 theme={null}
  {
    "code": 400,
    "message": "Sku already exists."
  }
  ```

  ```json 401 theme={null}
  {
    "code": 401,
    "message": "Unauthorized"
  }
  ```
</ResponseExample>