Skip to main content
POST
/
api
/
inventory
Create inventory
curl --request POST \
  --url https://app.buylo.ai/api/inventory \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Monthly stock check",
  "type": "WAREHOUSE",
  "statuses": [
    "in_stock",
    "lost"
  ],
  "warehouse_node_id": 44,
  "location_id": 21,
  "epcs": [
    "<string>"
  ]
}
'
{
  "data": {
    "id": 12,
    "name": "Monthly stock check",
    "type": "WAREHOUSE",
    "warehouse_node_id": 44,
    "warehouse_node_path": "WH/ZoneA/Rack-03",
    "location_id": 21,
    "location_name": "Showroom",
    "statuses": [
      "in_stock",
      "lost"
    ],
    "created_at": "2025-10-22T08:12:34Z",
    "total_epcs": 57,
    "unique_products": 12,
    "items": [
      {
        "id": 17,
        "product_id": 501,
        "product_name": "ACME Mug",
        "ean": "8591234567890",
        "count": 3,
        "epc_hashes": [
          {
            "hash": "8aaedfc3559d0ce545ca55bcea31aad2",
            "warehouse_location": "WH/ZoneA/Rack-03/Shelf-2"
          }
        ],
        "created_at": "2025-10-22T08:12:34Z"
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
name
string
required
Maximum string length: 255
Example:

"Monthly stock check"

​
type
string
required

Must be one of the server enum values

Example:

"WAREHOUSE"

​
statuses
string[] | null
Example:
["in_stock", "lost"]
​
warehouse_node_id
integer | null

Required when type=WAREHOUSE

Example:

44

​
location_id
integer | null

Required when type=LOCATION

Example:

21

​
epcs
string[] | null

Optional list of EPC IDs to include

Response

Created

​
data
object
required