adds or updates a product with attributes, options and combinations.

Creates or updates a product including its attributes, options and combinations. Combinations are replaced, not appended: every combination not present in the submitted product_variants is deleted from the product after import. 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 (small imports: a few minutes after the slot; large imports — many variants/combinations — can take significantly longer).

Product payload sections — see the introduction document for full context:

dependable_attributes: Isolated options that are always available in every combination without price effect.

independent_options: Add-on options with their own price surcharge (referenced later in basket / order).

product_variants: The primary combination + pricing matrix.

Upload size: keep each submitted import file at or below 10 MB. To import a larger combination dataset, split it into multiple chunks and submit them sequentially via POST /api/products/combinations.

Request

Header Params

Body Params application/json

Example

{
    "key": "ext-product-1",
    "category_id": "c1111111-1111-1111-1111-111111111111",
    "currency": "EUR",
    "name": "Visitenkarten Standard",
    "country_code": "DE",
    "product_type": "standard",
    "product_variants": [],
    "independent_options": [],
    "dependable_attributes": []
}

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",
            "name": "Visitenkarten Standard"
        }
    }
}

🟠401Unauthorized request