---
title: "Create Transfer Order"
method: POST
path: "/transfer-orders"
tags: ["transfer_order"]
---

# Create Transfer Order

`POST /transfer-orders`

## Request

- Base URL: `https://app.zenventory.com/rest`
- URL: `https://app.zenventory.com/rest/transfer-orders`
- Auth: none declared

Create a new transfer order.

## Request body

- object
  - `originWarehouseId` integer, required: Id of the warehouse the inventory is being transferred from.
  - `originWarehouseName` string, required: Name of the warehouse the inventory is being transferred from. Ignored if originWarehouseId is provided.
  - `destinationWarehouseId` integer, required: Id of the warehouse the inventory is being transferred to.
  - `destinationWarehouseName` string, required: Name of the warehouse the inventory is being transferred to. Ignored if destinationWarehouseId is provided.
  - `requiredBy` unknown, required
  - `draft` boolean: True if the transfer order is a draft.
  - `shipVia` string: The code of the carrier or service to use for shipping.
  - `notes` string
  - `items` object[]: Items being transferred.
    - `itemId` integer, required: Id of the item master.
    - `sku` string, required: SKU of the item master. Ignored if itemId is provided.
    - `quantity` integer, required: How many are being transferred. Must be nonzero.

## Response `201`

Success

- TransferOrder
  - `id` integer
  - `originWarehouse` WarehouseCompact
    - `id` integer
    - `name` string
  - `destinationWarehouse` WarehouseCompact
    - `id` integer
    - `name` string
  - `draft` boolean
  - `completed` boolean
  - `requiredBy` string, date-time
  - `createdDate` string, date-time
  - `preparedBy` UserCompact
    - `id` integer
    - `name` string
  - `preparedDate` string, date-time
  - `shipVia` string
  - `deleted` boolean
  - `deletedBy` UserCompact
    - `id` integer
    - `name` string
  - `deletedDate` string, date-time
  - `cancelled` boolean
  - `cancelledBy` UserCompact
    - `id` integer
    - `name` string
  - `cancelledDate` string, date-time
  - `cancelledReason` string
  - `notes` string
  - `tags` Tag[]
    - `id` integer
    - `tag` string
    - `note` string
  - `items` TransferOrderItem[]
    - `id` integer
    - `itemId` integer
    - `sku` string
    - `description` string
    - `quantity` integer
    - `uom` string
    - `allocatedQuantity` integer
    - `pickedQuantity` integer
    - `deliveredQuantity` integer

---

[API](https://skmtc.dev/zenventory/apis/zenventory-rest-api.md) · [All operations](https://skmtc.dev/zenventory/apis/zenventory-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zenventory/apis/zenventory-rest-api/revisions/b40aa340773b?raw)