This call is deprecated. We recommend to use PIM API instead.

The corresponding new call is: POST /v1/matrix/dimension/value.

Add a new value (specific color or size) to a matrix dimension.

A matrix dimension is necessary for setting up matrix products. Typical matrix dimensions are, for example, "Size" (in which the values might be 2, 4, 6, 8 — or S, M, L, XL) and "Color" (which may contain Blue, Red, Black, Green etc).

To create a new dimension, see saveMatrixDimension. To edit an existing value (to change its name or code), see editItemInMatrixDimension. To delete a value, see removeItemsFromMatrixDimension.

Input parameters

Parameter name Description Possible value Required
dimensionID Dimension ID. Integer yes
name Variation name. Use either general parameter "name" or one or more of the following parameters if you need to set the names in specific languages. To have multilingual names enabled, please contact our customer support. An error will be returned if you attempt to set a name in a specific language and the multilingual names are not enabled on your account. String yes
nameENG String
nameSPA String
nameGER String
nameSWE String
nameFIN String
nameRUS String
nameEST String
nameLAT String
nameLIT String
nameGRE String
code Variation code. String


Field name Type Description
itemID Integer ID of the created value.