Developer changelog

As of 2023-04, select partners can use Server Pixels to consume customer events on the server-side. These new mutations are available to those partners:

• serverPixelCreate
• eventBridgeServerPixelUpdate
• pubSubServerPixelUpdate
• serverPixelDelete

As of the 2023-04 release of the GraphQL Admin API, you can create a subscription contract in a single operation with the subscriptionContractAtomicCreate mutation.

You can also replace a retired product by a new one, or update the price of a product in a subscription contract in one GraphQL call to the subscriptonContractProductUpdate mutation.

More information on Bulk Operations can be found here

As of the 2023-04 API version of the Storefront API, the ProductRecommendations query will accept an optional intent argument. Additionally, a new ProductRecommendationIntent will be introduced as a GraphQL Enum Type, defining the supported product recommendation intents. By default, the API will return RELATED recommendations for backward compatibility.

We've added the error codes INVALID_DELIVERY_GROUP and INVALID_DELIVERY_OPTION for cartSelectedDeliveryOptionsUpdate mutation , allowing you to get descriptive error codes when GraphQL returns invalid delivery group id or invalid delivery options input.

As of version 2023-04, payments apps will have support for onsite credit card payments through new types introduced to the GraphQL Payments Apps API. Changes to support on-site credit card processing are as follows:

• New rejection codes are now available in the paymentSessionReject GraphQL mutation for credit card payments apps
• A new error code is introduced in the paymentSessionPending GraphQL mutation

As of GraphQL Admin API version 2023-04, you can now use the Customer Merge API to combine two separate customer profiles with certain non-blocking criteria. You can use the new mutations and queries to:

• Preview a customer merge
• Merge two customers
• Follow the status of an ongoing merge

Additionally, you can check whether a customer can be merged with another customer using the new Customer.mergeable field. This field is also available on the CustomerSegmentMember API CustomerSegmentMember. mergeable.

You can learn more about merging customer profiles on Shopify Help Center.

You can now filter orders by their return status.

The return_status filter is available on the orders connection. This status corresponds to the return status merchants see in the orders page.

Learn more about the order's return status on Shopify.dev.

Learn more about return statuses on the help center.

In the Admin GraphQL API version 2023-04, the productVariantsBulkUpdate mutation will return product and productVariants data even when errors are present. Previously, the mutation would always return null for the product and productVariants data.

Learn more about the mutation here.