post

/products/update

Updates existing Product.

Returns

An updated product.

Request Parameters

3 Query Parameters

Request Body

Schema
object
name
string

The name of the product. Use the following template to build your product names: Main brand + Sub-brand, family or product name + Up to 3 key attributes + Generic product type. Product names must be clear and concise and should also be descriptive of the product being sold.
100 characters max.
Acceptable: “Men’s Dress Casual Shirt Navy”, “Women’s Solid Color Black Dress Pants”
Unacceptable: “Best Price!!! CHEAP Baby Stroller!!!”

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

1 validation + required
description
string

Description of the product, interpreted as plain text — HTML markup will not be processed. You can use “\n” to separate lines. Information about size, fit, and measurements would be helpful for apparel items
10,000 characters max.
Acceptable: “This dress shirt is 100% cotton and fits true to size.”
Unacceptable: “This <b>dress shirt</b> is 100% cotton and <i>fits true to size</i>.”

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

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. You can specify one or more additional images separated by the character |.

landingPageUrl
string

URL on your 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]

Non-hierarchical keyword or term assigned to each product in your feed. This kind of metadata helps describe an item and allows it to be categorized and found again by browsing or searching on Joom.it. Select up to 5 per product. Tags should be comma separated, but do NOT use commas in individual tags. The more tags you add, and the more accurate your tags, the better the chances our users will find your products. There is a maximum of 10 tags allowed per product, if you add more than 10 we ignore the extra tags
Acceptable: “Shirt, Men’s Fashion, Navy, Blue, Casual, Apparel”, “Women’s Fashion, Jewelry & Watches”, “Men’s Fashion, Suits, Mafia, Silk Tie, Ties”
Unacceptable: “Clearance Items”, “Cheap Cheap Cheap”

enabled
boolean

State of a newly created product

dangerousKind
string

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

1 validation
brand
string

Brand or manufacturer of your product

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. Do not include company logos or names or promotional or other identifying text. Images should be at least 550×550 pixels in size. Images should be square or almost square. Do not include any “image not found” images.
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

warrantyDays
integer

Product warranty period (in days)

expirationDays
integer

Product expiration time (in days)

eac
boolean

Eurasian Conformity (EAC)

variants
array[object]

Responses

Schema
object
data
object
code
integer

Status code for the request: 0 for success, any other number for failure

1 validation + required
message
string

Human readable description of what went wrong if code is not 0

Send a Test Request

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