--- title: inventoryTransferCreate - GraphQL Admin description: Creates an inventory transfer. api_version: unstable api_name: admin source_url: html: https://shopify.dev/docs/api/admin-graphql/unstable/mutations/inventoryTransferCreate md: https://shopify.dev/docs/api/admin-graphql/unstable/mutations/inventoryTransferCreate.md --- # inventory​Transfer​Create mutation Requires `write_inventory_transfers` access scope. Also: The user must have permission to manage inventory. Creates an inventory transfer. ## Arguments * input [Inventory​Transfer​Create​Input!](https://shopify.dev/docs/api/admin-graphql/unstable/input-objects/InventoryTransferCreateInput) required The input fields for the inventory transfer. *** ## Inventory​Transfer​Create​Payload returns * inventory​Transfer [Inventory​Transfer](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryTransfer) The created inventory transfer. * user​Errors [\[Inventory​Transfer​Create​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryTransferCreateUserError) non-null The list of errors that occurred from executing the mutation. *** ## Examples * ### inventoryTransferCreate reference ## Mutation Reference ```graphql mutation inventoryTransferCreate($input: InventoryTransferCreateInput!) { inventoryTransferCreate(input: $input) { inventoryTransfer { # InventoryTransfer fields } userErrors { field message } } } ``` ## Input ```json { "input": { "originLocationId": "gid://shopify//10079785100", "destinationLocationId": "gid://shopify//10079785100", "lineItems": [ { "inventoryItemId": "gid://shopify//10079785100", "quantity": 1 } ], "dateCreated": "2019-09-07T15:50:00Z", "note": "", "tags": [ "" ], "referenceName": "" } } ``` ##### Variables ``` { "input": { "originLocationId": "gid://shopify//10079785100", "destinationLocationId": "gid://shopify//10079785100", "lineItems": [ { "inventoryItemId": "gid://shopify//10079785100", "quantity": 1 } ], "dateCreated": "2019-09-07T15:50:00Z", "note": "", "tags": [ "" ], "referenceName": "" } } ``` ##### Schema ``` input InventoryTransferCreateInput { originLocationId: ID destinationLocationId: ID lineItems: [InventoryTransferLineItemInput!]! dateCreated: DateTime note: String tags: [String!] referenceName: String } input InventoryTransferLineItemInput { inventoryItemId: ID! quantity: Int! } ```