Skip to main content
POST
/
api
/
v2
/
products
Create product
curl --request POST \
  --url https://live.nocnocstore.com/api/v2/products \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <x-api-key>' \
  --data '
{
  "sku": "<string>",
  "brand": "<string>",
  "available_quantity": 123,
  "price": 123,
  "currency_code": "<string>",
  "title": "<string>",
  "description": "<string>",
  "description_language": "<string>",
  "condition": "<string>",
  "package_dimensions": {},
  "product_dimensions": {},
  "images": [
    {}
  ],
  "international_ids": {},
  "attributes": [
    {}
  ]
}
'
{
  "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" }
  ]
}
If you have an Amazon ASIN, use Create product by ASIN instead — it auto-populates product data automatically.

Authorization

X-Api-Key
string
required
Your seller API key. Provided by your nocnoc account manager.

Body parameters

sku
string
required
Alphanumeric unique code for the product. Between 1 and 45 characters.
brand
string
required
Brand of the product. Between 1 and 45 characters.
available_quantity
integer
required
Stock quantity. Between 0 and 9999.
price
number
required
Price of the product. Up to 10 integer digits and 2 decimal places.
currency_code
string
required
Currency code (ISO). Currently only USD is supported.
title
string
required
Product title to be published.
description
string
required
Product description to be published.
description_language
string
required
Language of the description. Currently only en is supported.
condition
string
Product condition. One of: NEW, USED, OPEN_BOX, REFURBISHED_A, REFURBISHED_B, REFURBISHED_C, REFURBISHED_D. Defaults to NEW.
package_dimensions
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.
product_dimensions
object
required
Dimensions of the product itself. Same structure as package_dimensions.
images
array
required
Array of image objects, each with a source_url field. Minimum 1, maximum 10.
international_ids
object
International identifiers. Contains gtin (array of strings — Global Trade Item Number, e.g. EAN, UPC).
attributes
array
Additional product attributes. Each object has type (one of: COLOR, SIZE) and value (string).

Returns

The created product object with all submitted fields confirmed.

Example request

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" }
    ]
  }'
{
  "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" }
  ]
}