This document is generated by Apidog. Apidog: All-in-one workspace for API design, document, debug, test, mock

Bulk Create Items

POST

/v1/item/bulk

Allows creating multiple items in a single request. This API will not return the item details because the process will be queued for a background task and the response will be returned instantly. It supports 500 maximum items per request and a limit of 5 maximum in-process background tasks per API Key.

Request

Header Params

Body Params application/json

Example

{
    "items": [
        {
            "name": "bmw m2",
            "image": "https://somecdn/image.jpeg",
            "sku": "bmwm2",
            "scannable": "bmwm2",
            "description": "bmw m2 rwd",
            "uom": "car",
            "base_unit": "each",
            "is_perishable": false,
            "is_batch_controlled": false,
            "is_tracked_by_serial_no": false,
            "is_hazmat": true,
            "hazmat_type": "LIMITED_QUANTITY"
        },
        {
            "name": "bmw m3",
            "image": "https://somecdn/image.jpeg",
            "sku": "bmwm3",
            "scannable": "bmwm3",
            "description": "bmw m3 rwd",
            "uom": "car",
            "base_unit": "each",
            "receiving_unit": "trailer",
            "receiving_unit_base_conversion": "10",
            "shipping_unit": "maersk-ship",
            "shipping_unit_base_conversion": "100",
            "is_perishable": false,
            "is_batch_controlled": false,
            "is_tracked_by_serial_no": false,
            "is_hazmat": true,
            "hazmat_type": "LIMITED_QUANTITY"
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://nova-sandbox.leanafywms.com/v1/item/bulk' \
--header 'X-API-Key: a18041c79595392e562a5c7c' \
--header 'Content-Type: application/json' \
--data '{
    "items": [
        {
            "name": "bmw m2",
            "image": "https://somecdn/image.jpeg",
            "sku": "bmwm2",
            "scannable": "bmwm2",
            "description": "bmw m2 rwd",
            "uom": "car",
            "base_unit": "each",
            "is_perishable": false,
            "is_batch_controlled": false,
            "is_tracked_by_serial_no": false,
            "is_hazmat": true,
            "hazmat_type": "LIMITED_QUANTITY"
        },
        {
            "name": "bmw m3",
            "image": "https://somecdn/image.jpeg",
            "sku": "bmwm3",
            "scannable": "bmwm3",
            "description": "bmw m3 rwd",
            "uom": "car",
            "base_unit": "each",
            "receiving_unit": "trailer",
            "receiving_unit_base_conversion": "10",
            "shipping_unit": "maersk-ship",
            "shipping_unit_base_conversion": "100",
            "is_perishable": false,
            "is_batch_controlled": false,
            "is_tracked_by_serial_no": false,
            "is_hazmat": true,
            "hazmat_type": "LIMITED_QUANTITY"
        }
    ]
}'

Responses

🟢200Success

application/json

Bodyapplication/json

Examples

SuccessException

{
    "success": true,
    "payload": true
}

🔴500Server Error

🟠429Too Many Requests

Modified at 2026-07-27 18:38:07

Create item

Get Item