---
title: "Adds a new value to an existing item variation."
method: POST
path: "/v2/itemdetails/variationvalues/add"
tags: ["ItemdetailsCommand"]
---

# Adds a new value to an existing item variation.

`POST /v2/itemdetails/variationvalues/add`

## Headers

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

## Request body

- JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsAddItemVariationValueCommandRequest — Adds a new value to an existing item variation. - Request
  - `variationId` string, uuid
  - `variationValue` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsCreateVariationValue — Model Class: CreateVariationValue
    - `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

## Response `200`

VariationValue 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)