API Reference

Create stock adjustments

post
https://{domain_prefix}.retail.lightspeed.app/api/2026-07/stock_adjustments

Creates one or more stock adjustments in a single batch (1–1000 items per request).

🔒 Requires: inventory:write scope

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

A batch of 1–1000 stock adjustments to create.

stock_adjustments
array of objects
required
length between 1 and 1000

The stock adjustments to create.

stock_adjustments*

A single stock adjustment to create as part of a batch.

uuid
length between 1 and 36

Required when reason is CUSTOM; must be omitted otherwise.

uuid
required
length between 1 and 36

The ID of the outlet where the adjustment is recorded.

uuid
required
length between 1 and 36

The ID of the product to adjust.

string
required
length ≤ 32

Quantity to adjust. Must be a numeric string (e.g. "1" or "-3"). Negative for DAMAGE/EXPIRY/etc., positive for STOCK_FOUND/SAMPLE_FOR_SALE.

string
enum
required

The reason for a stock adjustment.

Negative reasons (require quantity < 0): DAMAGE, EXPIRY, INTERNAL_USE, THEFT, DONATION.
Positive reasons (require quantity > 0): STOCK_FOUND, SAMPLE_FOR_SALE.
For CUSTOM, the sign must match the referenced custom reason's type.

Responses

400

Bad Request

401

Unauthorized

403

Forbidden

Updated 18 days ago

Did this page help you?
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

Updated 18 days ago

Did this page help you?