--- title: inventoryTransferCreateAsReadyToShip - GraphQL Admin description: |- Creates an inventory transfer in ready to ship. > Caution: > As of 2026-01, this mutation supports an optional idempotency key using the `@idempotent` directive. > As of 2026-04, the idempotency key is required and must be provided using the `@idempotent` directive. > For more information, see the [idempotency documentation](https://shopify.dev/docs/api/usage/idempotent-requests). api_version: 2025-07 api_name: admin type: mutation api_type: graphql source_url: html: https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/inventorytransfercreateasreadytoship md: https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/inventorytransfercreateasreadytoship.md --- # inventory​Transfer​Create​As​Ready​To​Ship mutation Requires `write_inventory_transfers` access scope. Also: The user must have permission to manage inventory. Creates an inventory transfer in ready to ship. *** **Caution:** As of 2026-01, this mutation supports an optional idempotency key using the \@idempotent\ directive. As of 2026-04, the idempotency key is required and must be provided using the \@idempotent\ directive. For more information, see the \idempotency documentation\. *** ## Arguments * input [Inventory​Transfer​Create​As​Ready​To​Ship​Input!](https://shopify.dev/docs/api/admin-graphql/2025-07/input-objects/InventoryTransferCreateAsReadyToShipInput) required The input fields for the inventory transfer. *** ## Inventory​Transfer​Create​As​Ready​To​Ship​Payload returns * inventory​Transfer [Inventory​Transfer](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/InventoryTransfer) The created inventory transfer. * user​Errors [\[Inventory​Transfer​Create​As​Ready​To​Ship​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/InventoryTransferCreateAsReadyToShipUserError) non-null The list of errors that occurred from executing the mutation. *** ## Examples * ### inventoryTransferCreateAsReadyToShip reference