---
title: inventoryShipmentCreateInTransit - GraphQL Admin
description: |-
  Adds an in-transit shipment to an inventory transfer.

  > 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/inventoryshipmentcreateintransit
  md: https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/inventoryshipmentcreateintransit.md
---

# inventory​Shipment​Create​In​Transit

mutation

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

Adds an in-transit shipment to an inventory transfer.

***

**Caution:** As of 2026-01, this mutation supports an optional idempotency key using the \<code>@idempotent\</code> directive. As of 2026-04, the idempotency key is required and must be provided using the \<code>@idempotent\</code> directive. For more information, see the \<a href="https://shopify.dev/docs/api/usage/idempotent-requests">idempotency documentation\</a>.

***

## Arguments

* input

  [Inventory​Shipment​Create​Input!](https://shopify.dev/docs/api/admin-graphql/2025-07/input-objects/InventoryShipmentCreateInput)

  required

  The input fields for the inventory shipment.

***

## Inventory​Shipment​Create​In​Transit​Payload returns

* inventory​Shipment

  [Inventory​Shipment](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/InventoryShipment)

  The created inventory shipment.

* user​Errors

  [\[Inventory​Shipment​Create​In​Transit​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/InventoryShipmentCreateInTransitUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### inventoryShipmentCreateInTransit reference