Step 3. Create stocks

This step guides through the process for creating stock. Stock represents a virtual, aggregated inventory of products for sources of your sales channels. Each stock maps sales channels with sources to determine available inventories and salable quantities.

A sales channel can only be assigned to one stock.

The stock_id of the default stock is 1. You cannot delete or add sources to the default stock, but you can perform these actions with custom stocks.

For more information about stock, see Inventory Management overview.

Create the stock

The POST V1/inventory/stocks endpoint creates a stock. The name, type, and code attributes are required. The code value cannot be changed.

Endpoint:

POST <host>/rest/default/V1/inventory/stocks

Scope:

default store view

Headers:

Content-Type: application/json

Authorization: Bearer <admin_token>

Payload:

The name attribute is required.

{
  "stock": {
    "name": "US Stock",
    "extension_attributes": {
      "sales_channels": [
        {
          "type": "website",
          "code": "base"
        }
      ]
    }
  }
}
Copied to your clipboard
{
  "stock": {
    "name": "US Stock",
    "extension_attributes": {
      "sales_channels": [
        {
          "type": "website",
          "code": "base"
        }
      ]
    }
  }
}