# Create a new variant

**POST /products/{productId}/variants**




## Servers



## Parameters
### Headers
- **X-Application-Name** (string)


### Path parameters
- **productId** (string)
  Partner's product identifier

### Query parameters
- **client_id** (string)
  Client identifier

### Body:  (object)

- **id** (string)
  Partners article (product/variant) ID (validated against `/[a-z0-9_][a-z0-9\-_.]*/i` regex pattern)
- **title** (string)
  Title of product (max. length is 200 chars)
- **shortdesc** (string)
  Short description of the product
- **longdesc** (string)
  Long description of the product (it can also contains simple html formatting)
- **priority** (integer)
  Priority for ordering products on list (or variants in context of product) - higher number means a higher priority on list
- **barcode** (string)
  EAN code of product/variant (if the product has variants, use this attribute only in the variant data structure)
- **price** (number)
  Price of product (used only if the product is without variants, otherwise it is in the variant data structure)
- **rrp** (number)
  Recommended retail price (if the product has variants, use this attribute only in the variant data structure)
- **media** (array[object])
  Product media with supported types: JPEG, GIF, PNG. Format PDF can be uploaded only for information list and energy labels. Format of picture is 4:3 (max. width 2000px) or 3:4 (max. height 2000px), max. 1.5 MB. URL cannot contain IP address or port. If the product has variants, use this attribute only in the variant data structure. If you want to update product/variant image, you need to make any change to the image URL
- **promotions** (array[object])
  Promotions data of product/variant. Promotion is highlighted on product list/detail of product. If the product has variants, use this attribute only in the variant data structure.
- **labels** (array[object])
  Labels data of the product/variant. Labels are used for sorting products. Each product can have assigned any number of valid labels. There are some standard labels - if partner wants special labels, it must be created in cooperation with MALL. See Labels.
- **parameters** (object)
  an array of parameters. Should you send one or more values, it is required to send them as an array of values for each parameter. Parameter value must be a string or an array of strings. See example.
- **dimensions** (object)

- **availability** (object)

- **recommended** (array[string])
  Ids of recommended products (if the product has variants, use this attribute only in the variant data structure). Max. limit of recommended products is 30.
- **delivery_delay** (integer)
  Number of days the delivery will be delayed for the product or variant. Value 0 means the item can be delivered the same day. If the product has variants and they have different value, use this attribute in the variant data structure. If the value is the same for all variants, it is enough to use the attribute only in the product data structure.
- **free_delivery** (boolean)
  Activate / deactivate free delivery for the whole purchase (package) containing this article
- **package_size** (string)
  `smallbox` or `bigbox` package size
- **mallbox_allowed** (boolean)
  Allowed/denied Mallbox delivery


## Responses
### 201
Variant detail OK response

#### Body:  (object)
- **data** (object)

- **result** (object)



[Powered by Bump.sh](https://bump.sh)