Create Inventory Hold

Creates an inventory hold, which keeps the held units from being shipped.

General description

  • Currently every hold is placed on an Advance Shipping Notice (ASN): it covers products expected on the receiving and must be created before the receiving starts being received; afterwards the request is rejected. Other kinds of holds may become available later.
  • Each item holds one product, optionally narrowed down to a single lot number and/or expiration date.
  • A single ASN can carry several holds, each identified by the returned inventory_hold_uuid.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

Advance Shipping Notice (ASN) number of the receiving the hold applies to. The receiving must not have started being received yet.

string
required
length between 3 and 255

Name of the inventory hold, shown in the ShipMonk app. Use it to tell your holds apart, e.g. by the reason for holding.

items
array of objects
required

Products to hold. Each item holds one product, optionally narrowed down to a single lot.

items*
string | null
Defaults to null

Note explaining why the inventory is held. Visible in the ShipMonk app to both you and ShipMonk.

Response

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