post

/products/create

Creates a new product.

Fields that are not required can be omitted (no need to send null or default values like "" or false for them).

To create new variants for an existing product, use update endpoint.

Returns

The created product.

Request Body

Schema
object
sku
string

Unique identifier that merchant uses for the product

required
storeId
string

Joom ID of a store where this product must be put. If the client is authorized as a store, this field should be omitted, because the product will be created in that store. If the client is authorized as the merchant, this field is required.

name
string

Name

required
description
string

Description of the product, interpreted as plain text. HTML markup will not be accepted. You can use “\n” to separate lines.

extraImages
array[string]

URL of extra photos of your product, no more than 20. Link directly to the image, not the page where it is located. The format and size requirements as the same as for the main_image field.

landingPageUrl
string

URL on merchant’s website containing the product details.

gtin
string

Global Trade Item Number (GTIN), may be 8, 12, 13 or 14 digits long, contains no letters or other characters.
Acceptable: “716393133224”
Unacceptable: “asdf884445ds”

tags
array[string]

Tags (not visible to customers, used as search keywords)

enabled
boolean

Whether the product is eligible for sale

dangerKind
string

Product danger kind. If product is not dangerous, “notDangerous” should be used.

1 validation
brand
string

Brand or manufacturer

mainImage
string

URL of the main image of the product. Link directly to the image, not the page where it is located. We accept JPEG, PNG or GIF format.
Acceptable: “http://www.yourwebsite.com/images/7324204/3”, “http://www.yourwebsite.com/images/dress.jpg”
Unacceptable: “http://www.yourwebsite.com/images/dresses.html”

Details: https://merchant-help.joom.com/hc/en-us/articles/115003497334

required
categoryId
string

Joom’s unique identifier of the category

attributes
array[object]

Text attributes provided by the merchant

variants
array[object]
required

Responses

Product with its variants

Schema
object
data
object

Send a Test Request

Send requests directly from the browser (CORS must be enabled)
$$.env
1 variable not set
host