POST /2025-07/cloud/product

Method: POST

URL:

Sandbox URL:

Description: Creates a product on ZhenHub.

Parameters required to be sent

Parameter	Description	Type
title	Product title. The maximum length is 256.	String, Required
vendor	Product vendor. The maximum length is 64.	String
currency	Currency. The maximum length is 3.	String, Required
category	Category. The maximum length is 256.	String
body_html	Product description. The maximum length is 65535.	String
tags	Product tags. The maximum length is 2046.	Array
options	Variant options. The maximum length is 65535.	Object
variants	Variations or options available for a product or item.	Array
sku	SKU No. The maximum length is 128.	String, Required
title	Variants title. The maximum length is 256.	String, Required
retail_price	Product retail price. The maximum total digits 12, with 2 decimal places.	Number, Required
weight	Product weight. The maximum total digits 12, with 2 decimal places.	Number
weight_unit	Weight UOM: g, kg, oz, lb. The maximum length is 8.	String, Required
requires_shipping	Requires shipping, default value is true.	Boolean
unit	UOM: pcs, kg. The maximum length is 8.	String, Required

Body

{
  "title": "i like iphone",
  "vendor": "apple",
  "currency": "USD",
  "category": "phone",
  "body_html": "i like iphone too",
  "tags": [
    "apple",
    "iphone 6",
    "iphone"
  ],
  "options": {
    "color": [
      "black",
      "gold",
      "silver"
    ],
    "memory": [
      "64G",
      "128G",
      "256G"
    ]
  },
  "variants": [
    {
      "sku": "iphone6",
      "title": "iphone6 256G",
      "retail_price": 1680,
      "weight": 168,
      "weight_unit": "g",
      "requires_shipping": true,
      "unit": "pcs"
    }
  ]
}

Response

{
  "code": 200,
  "message": "Successful!",
  "data": 718553956438835212
}