---
title: "Adds a new variation (e.g., color, size) to an existing item. Variations allow customers to select different product options."
method: POST
path: "/v2/itemdetails/variations/add"
tags: ["ItemdetailsCommand"]
---

# Adds a new variation (e.g., color, size) to an existing item. Variations allow customers to select different product options.

`POST /v2/itemdetails/variations/add`

## Headers

- `x-tenant-id` string, uuid, required
- `x-runas` string
- `x-companyid` string

## Request body

- JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsAddItemVariationCommandRequest — Adds a new variation (e.g., color, size) to an existing item. Variations allow customers to select different product options. - Request
  - `itemId` string, uuid
  - `variation` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsCreateVariation — Model Class: CreateVariation
    - `variationId` string, uuid
    - `position` integer — Position of this Variation in the List
    - `descriptions` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsCreateDescription[] — Descriptions of this Variation in multiple Languages
      - `languageIso` string — ISO2 language code that determines the language for this item description (e.g., "DE" for German, "EN" for English).
      - `name` string — Name of the Variation in the specific language
    - `values` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsCreateVariationValue[] — Values for this Variation
      - `variationValueId` string, uuid
      - `itemNumber` string — Itemnumber for this variationvalue
      - `gTIN` string — GTIN for this variationvalue
      - `weightOffset` number — Offset for the weight of this variationvalue
      - `descriptions` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsCreateDescription[] — Descriptions of this VariationValue in multiple Languages
        - `languageIso` string — ISO2 language code that determines the language for this item description (e.g., "DE" for German, "EN" for English).
        - `name` string — Name of the Variation in the specific language
      - `surcharges` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsCreateVariationValueSurcharges — Model Class: CreateVariationValueSurcharges
        - `defaultSurchargeNet` number — Default Surcharge if there is none specified for a specific saleschannel + customergroup
        - `customerGroupSurcharges` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsCreateCustomerGroupSurcharge[] — Default Surcharges for specific customergroups in general, independent of saleschannel
          - `customerGroupId` string, uuid
          - `surcharge` number — Surcharge for that customergroup
          - `isActive` boolean — Defines if the surcharges will be synchronized to online saleschannels. Does not apply for the default customer group surcharges, which are always synchronized when not overriden.
        - `salesChannelSurcharges` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsCreateSalesChannelSurcharge[] — Surcharge for specific saleschannels + customergroups
          - `salesChannelId` string — Represents a unique identifier for a sales channel, encapsulating various platform-specific keys such as shop, user, or channel identifiers.
          - `surcharges` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsCreateCustomerGroupSurcharge[] — Contains the surcharges for that saleschannel and customergroup
            - `customerGroupId` string, uuid
            - `surcharge` number — Surcharge for that customergroup
            - `isActive` boolean — Defines if the surcharges will be synchronized to online saleschannels. Does not apply for the default customer group surcharges, which are always synchronized when not overriden.
      - `position` integer — Position of this VariationValue in the List
      - `image` string, uuid
    - `variationType` 0 | 1 | 2 | 3 | 4 | 5 | 6 — 0 = Unknown, 1 = Selectbox, 2 = Radiobutton, 3 = Swatches, 4 = Textbox, 5 = FreeText, 6 = MandatoryFreeText

## Response `200`

Variation was successfully added to the item.

---

[API](https://skmtc.net/jtl-software/apis/scx-authentication-api.md) · [All operations](https://skmtc.net/jtl-software/apis/scx-authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jtl-software/scx-authentication-api/revisions/f979b1ea6951/schema)