Upsert product

PUT

/products

Creates or fully replaces a product, keyed on productId (client_id + plugin). Healing: inactive placeholder products created by /carts/checkout or order import for unknown items are matched on the same key and filled in by this upsert.

Set semantics: when variants is present, it replaces the whole variant set — variants missing from the payload are deactivated (not deleted; order items may reference them). When categories is present it replaces category membership; same for tags.

Request

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Updated

Bodyapplication/json

🟢201Created

🟠400Bad Request

🟠422Parameter Error

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT '/products' \
--header 'Content-Type: application/json' \
--data '{
    "productId": "string",
    "active": 1,
    "sku": "string",
    "ean": "string",
    "brand": "string",
    "unit": "string",
    "condition": "new",
    "stock": 0,
    "availability": 0,
    "tax": 0,
    "purchase": {
        "amount": 0,
        "currency": "string"
    },
    "prices": [
        {
            "amount": 0,
            "currency": "CZK",
            "country": "string",
            "pricelist": "string",
            "priceAfterDiscount": 0,
            "priceWithoutTax": 0,
            "discountRate": 0,
            "measurePrice": 0,
            "measureAmount": 0,
            "measureUnitName": "kg"
        }
    ],
    "imageUrls": [
        "http://example.com"
    ],
    "categories": [
        "string"
    ],
    "tags": [
        {
            "name": "new"
        }
    ],
    "related": [
        "string"
    ],
    "languages": [
        {
            "id": "cs",
            "name": "string",
            "url": "http://example.com",
            "description": "string",
            "shortDescription": "string",
            "attributes": [
                {
                    "key": "size",
                    "value": "XL"
                }
            ]
        }
    ],
    "added": "2019-08-24T14:15:22.123Z",
    "validFrom": "2019-08-24T14:15:22.123Z",
    "validTo": "2019-08-24T14:15:22.123Z",
    "variants": [
        {
            "variantId": "string",
            "sku": "string",
            "ean": "string",
            "active": 0,
            "condition": "new",
            "stock": 0,
            "availability": 0,
            "prices": [
                {
                    "amount": 0,
                    "currency": "CZK",
                    "country": "string",
                    "pricelist": "string",
                    "priceAfterDiscount": 0,
                    "priceWithoutTax": 0,
                    "discountRate": 0,
                    "measurePrice": 0,
                    "measureAmount": 0,
                    "measureUnitName": "kg"
                }
            ],
            "imageUrls": [
                "http://example.com"
            ],
            "languages": [
                {
                    "id": "cs",
                    "name": "string",
                    "url": "http://example.com",
                    "description": "string",
                    "shortDescription": "string",
                    "attributes": [
                        {
                            "key": "size",
                            "value": "XL"
                        }
                    ]
                }
            ],
            "customFields": [
                {
                    "key": "string",
                    "value": "string",
                    "group": "string"
                }
            ],
            "validFrom": "2019-08-24T14:15:22.123Z",
            "validTo": "2019-08-24T14:15:22.123Z"
        }
    ]
}'

Response Example

200 - Example 1

{
    "productId": "string",
    "status": "created"
}

Modified at 2026-07-07 12:02:40

Create product

Upsert multiple products (sync)