> ## Documentation Index
> Fetch the complete documentation index at: https://developer.jtl-software.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AddItemVariation

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

If a request with this mutation's Idempotency-Key was already completed, the response's `extensions` contains an `idempotency.{responseName}` entry with `wasReplayed: true`.



**mutation** `AddItemVariation(request: AddItemVariationCommandRequestInput!): AddItemVariationCommandResponse!`

## Arguments

**`request`**: `AddItemVariationCommandRequestInput!` (required)

## Returns

`AddItemVariationCommandResponse!`

**`variationId`**: `ID!`

Unique ID of the newly added variation.

## Examples

```graphql Mutation
mutation AddItemVariation($request: AddItemVariationCommandRequestInput!) {
  AddItemVariation(request: $request) {
    variationId
  }
}
```

```json Variables
{
  "request": {
    "itemId": "id",
    "variation": {
      "descriptions": [
        {
          "languageIso": "string",
          "name": "string"
        }
      ],
      "variationType": "UNKNOWN"
    }
  }
}
```

```json Response
{
  "data": {
    "AddItemVariation": {
      "variationId": "id"
    }
  }
}
```
