Skip to main content
Anchor to inventoryTransferCreate

inventoryTransferCreate

mutation

Requires write_inventory_transfers access scope. Also: The user must have permission to manage inventory.

Creates a draft inventory transfer to move inventory items between Location objects in your store. The transfer tracks which items to move, their quantities, and the origin and destination locations.

Use inventoryTransferMarkAsReadyToShip to mark the transfer as ready to ship.


Caution

As of version 2026-01, this mutation supports an optional idempotency key using the @idempotent directive. As of version 2026-04, the idempotency key is required and must be provided using the @idempotent directive. For more information, see the idempotency documentation.


•InventoryTransferCreateInput!
required

The input fields for the inventory transfer.


Was this section helpful?

Anchor to InventoryTransferCreatePayload returnsInventoryTransferCreatePayload returns

•InventoryTransfer

The created inventory transfer.

•[InventoryTransferCreateUserError!]!
non-null

The list of errors that occurred from executing the mutation.


Was this section helpful?