POST

Connects an inventory item to a location by creating an inventory level at that location. 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/connect.json

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

Access Token Required: API Key

Query Params

inventory_item_id requiredstring

The ID of 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.

relocate_if_necessarystring

Whether inventory for any previously connected locations will be relocated. This property is ignored when no fulfillment service location 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/connect.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}