# Create an inventory request (Beta)

**POST /api/external/hub/v1/inventory_requests**




## Servers
- Public API: https://api.useshelf.com (Public API)



## Parameters



### Body: application/json (object)

- **warehouse_id** (integer)
  ID of the destination warehouse
- **notes** (string)
  Optional notes for the inventory request
- **estimated_ship_date** (string(date))
  Estimated ship date (YYYY-MM-DD)
- **shipment_method** (string)
  Shipment method
- **packslip_source** (string)
  Packslip source (optional)
- **items** (array[object])



## Responses
### 401
Unauthorized - missing or invalid authentication

#### Body: application/json (object)
- **error** (string)


### 422
Unprocessable Entity

#### Body: application/json (object)
- **success** (boolean)

- **errors** (array[string])


### 200
Inventory request created successfully

#### Body: application/json (object)
- **success** (boolean)

- **errors** (array[string])

- **ir_number** (string)
  The created inventory request number


[Powered by Bump.sh](https://bump.sh)