Introduce customer access token query, provider identifiers, shipment filter

3/19/2026, 12:01:08 AM

A new root‑level query customerByAccessToken lets apps retrieve a customer by a one‑time access token; it returns null when the token is invalid or already used. The Customer type gains a non‑null list identityProviderSubjects that returns the identities associated with a customer, backed by a new IdentityProviderSubject object that records provider name, subject ID, and timestamps. Shipping line information is now exposed on individual fulfillment order line items via the new shippingLine field. In the fulfillment order state machine, the deprecated action MARK_AS_IN_PROGRESS has been removed. Inventory transfer deletion error handling includes a new enum value INVALID_STATE. Shopify Payments transaction types are extended with BALANCE_TRANSFER_OUTBOUND. The inventoryShipments query’s query argument now accepts a tracking_number filter, and the channels field description was tightened to reflect only shop‑established channels.

Query Changes

➕ Added Queries (1)

customerByAccessToken

Retrieve a customer by consuming a single-use access token. Returns null
if the customer was not found or the access token has expired or has
already been consumed.

🔄 Modified Queries (2)

channels

The channels established on the target shop by the calling application.

inventoryShipments

Returns a paginated list of InventoryShipment objects.

Supports filtering by barcode (e.g. barcode:"12345"), status (e.g. status:"draft" or status:"in_transit"), and destination (e.g. destination_id:12345).

~ Modified argument: query

Type Changes

➕ Added Types (1)

🏗️IdentityProviderSubject➕ AddedOBJECT

Represents a customer's identity provider subject identifier.

Fields: createdAt, id, providerName, subject, updatedAt

🔄 Modified Types (5)

🏗️Customer🔄 Modified
Field added: identityProviderSubjects

The identity provider subject identifiers associated with this customer.

🏗️FulfillmentOrderAction🔄 Modified
Enum value removed: MARK_AS_IN_PROGRESS
🏗️FulfillmentOrderLineItem🔄 Modified
Field added: shippingLine

The shipping line associated with this line item.

🏗️InventoryTransferDeleteUserErrorCode🔄 Modified
Enum value added: INVALID_STATE
🏗️ShopifyPaymentsTransactionType🔄 Modified
Enum value added: BALANCE_TRANSFER_OUTBOUND