---
title: "product.variant.add.batch"
method: POST
path: "/product.variant.add.batch.json"
tags: ["product"]
---

# product.variant.add.batch

`POST /product.variant.add.batch.json`

## Request

- Base URL: `https://api.api2cart.com/v1.1`
- URL: `https://api.api2cart.com/v1.1/product.variant.add.batch.json`
- Auth: API key in header `x-api-key` and API key in header `x-store-key`

Add new product variants to the store.

## Request body

- ProductVariantAddBatch
  - `clear_cache` boolean
  - `reindex` boolean
  - `payload` object[], required: Contains an array of product variants objects. The list of properties may vary depending on the specific platform.
    - `product_id` string, required
    - `combination` object[], required: A unique combination that contains an array of options and their values, which form a variation.
      - `option_name` string, required
      - `option_value_name` string, required
    - `name` string
    - `description` string
    - `short_description` string
    - `sku` string, required
    - `model` string
    - `price` number
    - `old_price` number
    - `cost_price` number
    - `special_price` number
    - `sprice_create` string
    - `sprice_expire` string
    - `advanced_prices` object[]
      - `value` number, required
      - `group_id` integer
      - `quantity` number, required
    - `meta_title` number
    - `meta_description` number
    - `meta_keywords` string[]
    - `categories_ids` string[]
    - `stores_ids` string[]
    - `weight` number
    - `width` number
    - `height` number
    - `length` number
    - `weight_unit` string
    - `warehouse_id` string
    - `quantity` number
    - `manage_stock` boolean
    - `in_stock` boolean
    - `store_id` string
    - `lang_id` string
    - `tax_class_id` string
    - `backorder_status` string
    - `status` string
    - `visible` string
    - `is_virtual` boolean
    - `downloadable` boolean
    - `is_default` boolean
    - `upc` string
    - `isbn` string
    - `mpn` string
    - `ean` string
    - `barcode` string
    - `available_for_sale` boolean
    - `is_free_shipping` boolean
    - `taxable` boolean
    - `seo_url` string
    - `manufacturer_id` string
    - `harmonized_system_code` string
    - `marketplace_item_properties` object
    - `images` object[]
      - `url` string, required
      - `label` string
      - `name` string
      - `position` integer
      - `type` string
    - `product_images_ids` string[]
    - `related_products_ids` string[]
    - `up_sell_products_ids` string[]
    - `cross_sell_products_ids` string[]
  - `idempotency_key` string: A unique identifier associated with a specific request. Repeated requests with the same <strong>idempotency_key</strong> return a cached response without re-executing the business logic. <strong>Please note that the cache lifetime is 15 minutes.</strong>

## Response `200`

successful operation

- object
  - `return_code` integer
  - `return_message` string
  - `result` object
    - `job_id` string

---

[API](https://skmtc.dev/api2cart/apis/api2cart-openapi.md) · [All operations](https://skmtc.dev/api2cart/apis/api2cart-openapi/llms.txt) · [OpenAPI document](https://skmtc.dev/api2cart/apis/api2cart-openapi/revisions/c34440741693?raw)