Skip to main content

Create Inventory Adjustment

POST 
/api/inventory-adjustments

Create a new inventory adjustment. Supports increase, decrease, and set adjustment types.

Authentication: Requires Bearer token.

Fields:

  • adjustment_date (required): Date of adjustment in Y-m-d format
  • product_id (required): ID of the product to adjust (not bundles/matrix products)
  • warehouse_id (required): ID of the target warehouse (must have a default location)
  • quantity (required): Adjustment quantity (numeric, < 1,000,000, decimals supported e.g. 0.5). Must be non-zero for increase/decrease
  • adjustment_type (required): One of: increase, decrease, set. Default: increase
  • unit_cost (optional/required for increase/set): Cost per unit (must be >= 0). Required if product has no average cost
  • notes (optional): Free-text notes
  • warehouse_location_id (optional): Specific location within the warehouse
  • condition (optional): Item condition description
  • integration_unique_id (optional): External reference ID

Errors: 400 if insufficient stock (for decrease) or protected inventory conflict.

Request​

Responses​

Successful response