---
title: "Create a new product to the marketplace"
method: POST
path: "/product"
tags: ["product"]
---

# Create a new product to the marketplace

`POST /product`

Use this enpoint to create a single new product to the Marketplace. This enpoint expects a json document with one product. If you whant to upload multiple products in a single API call use POST /products method. The server will load each product as an individual item that can be manipulated using your own `skuSellerId`. This system is idenpontent, this means that once a `skuSellerId` is created it cannot be re-created using this tool. In order to update, edit a product use the PUT method with the correct reference to your `skuSellerId`

## Headers

- `authorization` string, required

## Request body

- Product
  - `productId` string — Brand Lovers Product ID. Use this to suggest a product association. This field is optional.
  - `skuSellerId` string, required — Unique Product Id (SKU) in the seller system
  - `productGroupId` string — Unique Product Group ID. Products with the same `productGroupId` will be grouped and displayed as a unique entry. Use `productGroupId` to group diferent SKUs that represent diferent colors, sizes, capacities, etc..
  - `title` string, required — Product name as advertised by manufacturer. This how the product will be displayed in the Marketplace
  - `description` string, required — Product description.
  - `brand` string, required — Brand name
  - `gtin` string[] — Array of product EAN and/or ISBN and/or ASIN codes
  - `categories` string[], required — Array of categories associated with this product
  - `images` string[], required — List of valid Product image URLs. HTTP or HTTPS are valid. HTTPS is prefered.
  - `videos` string[] — List of videos de URLs associated with this product. HTTP or HTTPS are valid. HTTPS is prefered.
  - `price` ProductPrice, required
    - `default` integer, required — List price, also known as MSRP (Manufacturer Suggest Retail Price) or the recommended retail price (RRP). All prices must be provided in cents. No commas or periods are accepeted. For example one dollar should be informed as 100. $1,2345.67 should be informed solely as 1234567
    - `offer` integer, required — Product price. This is what will be offered to the customer. All prices must be provided in cents. No commas or periods are accepeted. For example one dollar should be informed as 100. $1,2345.67 should be informed solely as 1234567
  - `stock` integer, required — Number of products availble for sale from the seller. Each new successfull order will automatically reduce the number of products available.
  - `dimensions` Dimensions
    - `weight` integer, required — Product weight in Grams. No commas or periods are accepeted. For example one killo must be informed as 1000. Another example 1 Kilo and 234 grams should be informed solely as 1234
    - `length` integer, required — Product length in millimeters. No commas or periods are accepeted. For example one meter produc must be informed as 1000. Another example 1 meter and 23 centimeters should be informed solely as 1230
    - `width` integer, required — Product width in millimeters. No commas or periods are accepeted. For example one meter produc must be informed as 1000. Another example 1 meter and 23 centimeters should be informed solely as 1230
    - `height` integer, required — Product height in millimeters. No commas or periods are accepeted. For example one meter produc must be informed as 1000. Another example 1 meter and 23 centimeters should be informed solely as 1230
  - `giftWrap` GiftWrap
    - `available` boolean, required — Flag that defines if this product is eligible for giftwrapping
    - `value` integer, required — Amount charged for gift wrap. All prices must be provided in cents. No commas or periods are accepeted. For example one dollar should be informed as 100. $1,2345.67 should be informed solely as 1234567
    - `messageSupport` boolean — Flag that defines if seller supports giftwrapp with a message
  - `attributes` ProductAttribute[], required — List of `key` `value` attributes of this product. This is very important for search and SEO optmization. Include all relevant information
    - `name` string, required — Attribute name
    - `value` string, required — Attribute value

## Response `200`

Sucess! Server received your request and will start background processing.

## Other responses

- `400` — Bad Request.
- `401` — Access denied. You're not authenticated or token expired. Check your request header the `authorization` field is required.

---

[API](https://skmtc.net/brandlovers/apis/brandlovers-marketplace-api-v1.md) · [All operations](https://skmtc.net/brandlovers/apis/brandlovers-marketplace-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brandlovers/brandlovers-marketplace-api-v1/revisions/cb3af6151ae4/schema)