curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.stateset.com/api/v1/warehouse-bins' \
--header "Authorization: Bearer $STATESET_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"aisle": "string",
"bin_type": "string",
"capacity": "San Francisco",
"code": "string",
"position": "string",
"rack": "string",
"shelf": "string",
"warehouse_id": 1001,
"zone": "string"
}'
{
"aisle": "string",
"bin_type": "string",
"capacity": "San Francisco",
"code": "string",
"created_at": "2026-08-31T14:22:05Z",
"id": 1001,
"is_active": true,
"position": "string",
"rack": "string",
"shelf": "string",
"updated_at": "2026-08-31T14:22:05Z",
"warehouse_id": 1001,
"zone": "string"
}
Create a bin
Create a bin
POST
/
api
/
v1
/
warehouse-bins
curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.stateset.com/api/v1/warehouse-bins' \
--header "Authorization: Bearer $STATESET_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"aisle": "string",
"bin_type": "string",
"capacity": "San Francisco",
"code": "string",
"position": "string",
"rack": "string",
"shelf": "string",
"warehouse_id": 1001,
"zone": "string"
}'
{
"aisle": "string",
"bin_type": "string",
"capacity": "San Francisco",
"code": "string",
"created_at": "2026-08-31T14:22:05Z",
"id": 1001,
"is_active": true,
"position": "string",
"rack": "string",
"shelf": "string",
"updated_at": "2026-08-31T14:22:05Z",
"warehouse_id": 1001,
"zone": "string"
}
Confirm your deployment before running this request. This page describes an API contract;
a published reference does not establish hosted availability. Check the dated
host report and obtain your deployment URL and credentials.
Replace the example host if your provisioned service uses a different URL.
Request body
CreateBinRequest
string,null
string,null
One of
pick, bulk, receiving, staging, quarantine, returns. Default pick.string,null
Optional per-SKU maximum on-hand quantity (decimal string).
string
required
Unique per warehouse.
string,null
string,null
string,null
integer (int32)
required
string,null
Response
BinResponse
string,null
string
required
string,null
string
required
string
required
integer (int32)
required
boolean
required
string,null
string,null
string,null
string
required
integer (int32)
required
string,null
Status codes
| Code | Meaning |
|---|---|
201 | — |
400 | — |
409 | — |
Using this contract
Read the source OpenAPI document for declared schemas and alternatives. This page also includes documented corrections from the spec overlays. Example IDs and values are illustrative; replace them with records from your workspace.curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.stateset.com/api/v1/warehouse-bins' \
--header "Authorization: Bearer $STATESET_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"aisle": "string",
"bin_type": "string",
"capacity": "San Francisco",
"code": "string",
"position": "string",
"rack": "string",
"shelf": "string",
"warehouse_id": 1001,
"zone": "string"
}'
{
"aisle": "string",
"bin_type": "string",
"capacity": "San Francisco",
"code": "string",
"created_at": "2026-08-31T14:22:05Z",
"id": 1001,
"is_active": true,
"position": "string",
"rack": "string",
"shelf": "string",
"updated_at": "2026-08-31T14:22:05Z",
"warehouse_id": 1001,
"zone": "string"
}
Last modified on September 21, 2026