> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beachdepository.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Outbound Request

> Create an outbound request with inventory items

Creates an outbound request to ship one or more inventory items out of vault for an FBO account.
Every item must currently belong to the FBO account and be in an `in_vault` status. The request is
created with a `pending` status and awaits vault staff approval.

**Permission:** `outbound_requests:create`

## Request body

<ParamField body="fboAccountId" type="string" required>
  ID of the FBO account requesting the outbound shipment.
</ParamField>

<ParamField body="notes" type="string">
  Optional free-text note describing the request.
</ParamField>

<ParamField body="items" type="array" required>
  The inventory items to include — at least one. Each entry contains:

  * `inventoryItemId` (string, required) — ID of the inventory item to ship out.

  `inventoryItemId` values must be unique within the request.
</ParamField>

## Response

Returns the created outbound request with its line items.

```json theme={null}
{
  "data": {
    "id": "jd7abc123xyz",
    "fboAccountId": "m97fbo456",
    "organizationId": "k57orgxyz",
    "status": "pending",
    "totalItems": 2,
    "approvedBySystem": false,
    "notes": "Ship to primary address",
    "items": [
      {
        "id": "j970item123",
        "outboundRequestId": "jd7abc123xyz",
        "productId": "jh7prod123",
        "inventoryItemId": "jk7inv456",
        "createdAt": "2025-06-15T09:00:00Z"
      }
    ],
    "createdAt": "2025-06-15T09:00:00Z"
  }
}
```
