adds or updates attributes, options and combinations of a product. Used to import combinations in parts

Creates or updates attributes, options and combinations of a product. Use this endpoint to upload combinations in chunks for the same product key; set finish_import: true only on the last chunk. Combinations are replaced, not appended — but deletion of removed combinations is deferred until finish_import: true: each intermediate chunk only adds its product_variants to the product. On the final chunk (finish_import: true), the server compares the accumulated combinations against the previously stored combinations and deletes combinations that were not part of any chunk in this import run. Same semantic applies to variant_sets.

IMPORTANT: the request is processed asynchronously. HTTP 200 only confirms acceptance — actual persistence is handled by a worker that runs every 10 minutes (at minute :00, :10, :20, … UTC). Wait time until visible = remaining minutes to the next slot + processing time, which scales with the import size.

Upload size: keep each submitted chunk file at or below 10 MB; split larger datasets into more chunks.

Request

Header Params

Body Params application/json

Example

{
    "key": "ext-product-1",
    "product_variants": [
        {
            "current_version": "sha1-of-variant-attributes",
            "attributes": [
                {
                    "attribute_id": "a1111111-1111-1111-1111-111111111111",
                    "option_id": "o1111111-1111-1111-1111-111111111111"
                },
                {
                    "attribute_key": "color",
                    "option_key": "red"
                }
            ],
            "quantities": [
                {
                    "quantity_id": "q1111111-1111-1111-1111-111111111111",
                    "quantity_value": "100",
                    "delivery": {
                        "de": {
                            "s1111111-1111-1111-1111-111111111111": {
                                "price": 7.9,
                                "shipping_price": 4.9,
                                "delivery_days": 3
                            }
                        }
                    }
                }
            ]
        }
    ],
    "finish_import": true
}

Responses

🟢200Returns the product.

application/json

Bodyapplication/json

Example

{
    "jsonapi": {
        "version": "1.0"
    },
    "data": {
        "type": "products",
        "id": "p1111111-1111-1111-1111-111111111111",
        "attributes": {
            "key": "ext-product-1"
        }
    }
}

🟠401Unauthorized request