Create Items

Creates items on OMS and synchronises with warehouse, maximum capacity is 50 items per request.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Submits a new item or SKU to the system for cataloging and warehouse registration. To minimize latency and support high-throughput operations, this endpoint processes requests asynchronously.

Response Behavior

This endpoint will always return a 201 Created status immediately upon receiving a structurally valid payload. This behavior is intentionally designed to eliminate wasted idle time and prevent blocking your application while the backend processes the registration.

🚧

Asynchronous Verification Required

A 201 Created response means the payload was successfully validated and queued, but it does not guarantee the item is fully registered in the underlying database yet. To confirm the actual registration status or check for validation errors during processing, you must query the Get Item endpoint (GET /v1/items/{sku}).

Response Status Codes

Status CodeStatusDescription
201CreatedRequest Queued: The item registration request has been accepted and is being processed in the background.
Body Params
items
array of objects
required

Item list

items*
string
required

Destination warehouse identifier code

Notice: The code is provided by Cargoholic.

Responses

401

Unauthorized

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json