> ## 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 Transfer

> Create a transfer between FBO accounts

Creates a transfer of one or more inventory items from one FBO account to another within the organization. Every item must currently belong to the source FBO account and be in an `in_vault` status. The transfer is created with a `pending` status.

**Permission:** `transfer_batches:create`

## Request body

<ParamField body="fromFboAccountId" type="string" required>
  ID of the FBO account the items are transferred from.
</ParamField>

<ParamField body="toFboAccountId" type="string" required>
  ID of the FBO account the items are transferred to. Must differ from `fromFboAccountId`.
</ParamField>

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

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

  * `inventoryItemId` (string, required) — ID of the inventory item to transfer.
  * `reason` (string, required) — Why the item is being transferred. One of `request`, `trade`, `rebalance`.

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

## Response

Returns the created transfer batch.

```json theme={null}
{
  "data": {
    "id": "xfer_new789",
    "fromFboAccountId": "fbo_abc123",
    "toFboAccountId": "fbo_def456",
    "organizationId": "org_abc123",
    "status": "pending",
    "totalItems": 2,
    "approvedBySystem": false,
    "notes": "Quarterly rebalance",
    "createdAt": "2025-06-15T09:00:00Z"
  }
}
```