Sets the inventory level for an inventory item at a location. If the specified location is not connected, it will be automatically connected first. When connecting inventory items to locations, it's important to understand the rules around fulfillment service locations.

https://shopify.com/admin/api/unstable/inventory_levels/set.json

https://shopify.dev/docs/admin-api/rest/reference/inventory/inventorylevel#set-unstable

Access Token Required: API Key

Query Params

inventory_item_id requiredstring

The ID for the inventory item.

location_id requiredstring

The ID of the location that the inventory level belongs to. To find the ID of the location, use the Location resource.

available requiredstring

Sets the available inventory quantity.

disconnect_if_necessarystring

Whether inventory for any previously connected locations will be set to 0 and the locations disconnected. This property is ignored when no fulfillment service is involved. For more information, see Inventory levels and fulfillment service locations. (default: false)

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request POST \
2     --url 'https://shopify.com/admin/api/unstable/inventory_levels/set.json' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}

POST