Create and Update Products

Upsert Product

post

Rate limit: 100 requests per minute

Authorizations

APIKeyAuth

X-API-KeystringRequired

Body

application/json

Responses

200

OK

application/json

batchRequestIdstring · uuidRequired

Unique identifier (UUID)

Example: 123e4567-e89b-12d3-a456-426614174000

400

Bad Request

application/json

401

Unauthorized

application/json

default

post

/api/v1/products/

HTTPcURLJavaScriptPython

POST /api/v1/products/ HTTP/1.1
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 608

{
  "items": [
    {
      "style_key": "master_1",
      "sku": "my_sku_1",
      "ean": "4006381333900",
      "hs_code": "1234.56",
      "name": "Gwendolyn",
      "descriptions": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "color": 1,
      "size": 1,
      "second_size": 1,
      "brand": 1,
      "category": 1,
      "quantity": 100,
      "weight": 400,
      "countries": [
        "DE"
      ],
      "country_of_origin": "DE",
      "attributes": [
        1
      ],
      "material_composition_textile": [
        {
          "cluster_id": 1,
          "components": [
            {
              "material_id": 1,
              "fraction": 100
            }
          ]
        }
      ],
      "material_composition_non_textile": [
        {
          "cluster_id": 1,
          "components": [
            {
              "material_id": 1
            }
          ]
        }
      ],
      "prices": [
        {
          "country_code": "DE",
          "retail_price": 100,
          "sale_price": 80
        }
      ],
      "images": [
        "https://aboutyou.com/image.jpg"
      ]
    }
  ]
}

{
  "batchRequestId": "123e4567-e89b-12d3-a456-426614174000"
}