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

# category.add.batch

`POST /category.add.batch.json`

## Request

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

Add new categories to the store.

## Request body

- CategoryAddBatch
  - `payload` object[], required: Contains an array of categories objects. The list of properties may vary depending on the specific platform.
    - `name` string, required
    - `avail` boolean
    - `description` string
    - `meta_title` string
    - `meta_description` string
    - `meta_keywords` string[]
    - `parent_id` string
    - `sort_order` integer
    - `seo_url` string
    - `store_id` string
    - `images` object[]
      - `url` string, required
      - `image_name` string
      - `type` string
      - `label` string
    - `stores_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)