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

# product.add.batch

`POST /product.add.batch.json`

## Request

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

Add new products to the store.

## Request body

- ProductAddBatch
  - `nested_items_update_behaviour` 'replace' | 'merge': Determines how updates to nested items should be handled.<hr><div style="font-style:normal"> Values description: <div style="margin-left: 2%; padding-top: 2%"> <div style="font-size:85%"> <b> replace</b>: This option indicates that the nested items should be completely replaced with the new data provided. </br> <b> merge</b>: With this option, updates to nested items are merged with the existing data. </br> </div> </div></div>
  - `clear_cache` boolean
  - `reindex` boolean
  - `payload` object[], required: Contains an array of product objects. The list of properties may vary depending on the specific platform.
    - `name` string
    - `description` string
    - `short_description` string
    - `sku` string
    - `model` string
    - `asin` string
    - `upc` string
    - `ean` string
    - `gtin` string
    - `mpn` string
    - `isbn` string
    - `barcode` string
    - `price` number
    - `old_price` number
    - `cost_price` number
    - `special_price` number
    - `sprice_create` string
    - `sprice_expire` string
    - `avail_from` string
    - `advanced_prices` object[]
      - `value` number, required
      - `group_id` integer
      - `quantity` number, required
      - `start_time` string
      - `expire_time` string
    - `fixed_cost_shipping_price` number
    - `buyitnow_price` number
    - `reserve_price` number
    - `best_offer` number
    - `quantity` number
    - `manage_stock` boolean
    - `product_type` string
    - `marketplace_item_properties` object
    - `specifics` object
    - `is_free_shipping` boolean
    - `taxable` boolean
    - `status` string
    - `condition` string
    - `condition_description` string
    - `visible` string
    - `available_for_view` boolean
    - `available_for_sale` boolean
    - `is_virtual` boolean
    - `in_stock` boolean
    - `type` string
    - `listing_type` string
    - `listing_duration` string
    - `downloadable` boolean
    - `weight` number
    - `length` number
    - `width` number
    - `height` number
    - `weight_unit` string
    - `dimensions_unit` string
    - `store_id` string
    - `lang_id` string
    - `category_id` string
    - `warehouse_id` string
    - `categories_ids` string[]
    - `related_products_ids` string[]
    - `up_sell_products_ids` string[]
    - `cross_sell_products_ids` string[]
    - `stores_ids` string[]
    - `tax_class_id` string
    - `sales_tax` object
      - `tax_percent` number
      - `taxable` boolean
    - `meta_title` string
    - `meta_description` string
    - `meta_keywords` string[]
    - `search_keywords` string[]
    - `harmonized_system_code` string
    - `url` string
    - `seo_url` string
    - `external_product_link` string
    - `manufacturer` string
    - `manufacturer_id` string
    - `backorder_status` string
    - `images` object[]
      - `type` string
      - `url` string, required
      - `label` string
      - `name` string
      - `position` integer
    - `tags` string[]
    - `files` object[]
      - `url` string, required
      - `name` string, required
  - `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)