Developer changelog

GraphQL Admin API 2024-10 adds heldByRequestingApp to FulfillmentHold. heldBy now requires read_apps scope. Use heldByRequestingApp to check app-created holds.

As of the GraphQL Admin API version 2024-10, the fulfillmentOrderHold mutation will return the fulfillment hold that was created in a new fulfillmentHold return field.

Learn more about the...

As of 2024-10, query events via eventsCount, event, and events. events connection added to multiple types. CommentEvent.subject is now nullable; deletionEvents deprecated.

In the 2024-10 Admin GraphQL API, ProductInput is split into ProductCreateInput and ProductUpdateInput. productCreate and productUpdate now use a new product argument.

Version 2024-10 of the Admin GraphQL API allows reading/modifying Pages, Articles, Blogs, and Comments with new types and queries, enhancing content management for developers.

Added API resource for local payment methods payment details, enhancing transaction data access for developers.

New "SubscriptionBillingAttempt" resource logs billing attempts with idempotency keys to avoid duplicates, creating orders on success. No impact on existing partners.

New resource logs each subscription billing attempt, using idempotency keys to prevent duplicate orders. Successful attempts create orders, no impact on existing partners.

API v2024-10 introduces admin API for Online Store Themes, matching REST API features. New queries and mutations enhance theme and file management, boosting efficiency for developers.

API version 2024-10 introduces metafield definition management via Admin API, allowing developers to enable, disable, and query metafield capabilities for enhanced Shopify integration.

API v2024-10 introduces the Metafield Definition Capability Framework, replacing use_as_collection_condition with smart_collection_condition for better flexibility and extensibility.

GraphQL API v2024-10 introduces ProductSetInventoryInput for setting available or on_hand quantities in ProductSet and ProductSetVariant mutations, enhancing inventory management.

GraphQL Admin API 2024-10: GiftCard endpoints open to all; new GiftCardTransaction types. Rename giftCardDisable to giftCardDeactivate. Add recipientAttributes and transaction fields.

As of the Admin API version 2024-10, the fulfillmentOrdersReleaseHolds mutation has been deprecated.

...

As of Admin GraphQL API version 2024-10, you can access QueryRoot.urlRedirectsCount field to retrieve the count of redirects.

Learn more about urlRedirectsCount on...

As of the 2024-10 version of the GraphQL Admin API, the products query filter has been expanded to allow filtering on additional attributes: publication_ids, variant_id and...

Several fields deprecated from Abandoned Checkout REST API; switch to new GraphQL API by 2024-10 for continued support.

GraphQL Admin API 2024-10 adds id to FulfillmentHold and optional holdIds to fulfillmentOrderReleaseHold mutation, allowing precise hold releases by ID.

As of Admin GraphQL API version 2024-10, you can access Order.statusPageUrl field to retrieve the URL where the customer can check the order's current status.

Learn more about Order on...

API v2024-10 introduces PRODUCT_CATEGORY_ID in CollectionRuleColumn for smart collections, replacing deprecated PRODUCT_TAXONOMY_NODE_ID. Update implementations for enhanced functionality.

As of 2024-10, we're deprecating fulfillmentCreateV2 and fulfillmentTrackingInfoUpdateV2. Instead, please use fulfillmentCreate and fulfillmentTrackingInfoUpdate.

Note that the...

The 2024-10 Admin REST API requires the read_locations scope to access the location resource. Without it, a 403 Forbidden error occurs. Update your app permissions accordingly.

GraphQL Storefront API 2024-10 now supports retrieving product taxonomy categories, enhancing storefront customization. Available via both GraphQL and Liquid APIs for improved buyer experience.

GraphQL Admin API 2024-10 adds stockAtLegacyLocation to inventoryActivate mutation, enabling inventory activation at non-SKU-sharing locations. Ensure parameter is true for such activations.

As of 2024-10, ReverseFulfillmentOrderLineItem.fulfillmentLineItem is nullable. Older API versions will error if fulfillmentLineItem is missing.

As of Admin GraphQL API version 2024-10, use Order.lineItems instead of lineItemsMutable field to get a list of the order's line items.

Learn more about Order on...

As of 2024-10 version, we are adding productVariantsCount field to the Admin GraphQL API.

Learn more about...

The 2024-10 GraphQL Admin API release removes HAS_OPEN_TRANSFERS_ERROR and FAILED_TO_RELOCATE_OPEN_TRANSFERS from LocationDeactivateUserErrorCode. Update code to remove checks.

As of GraphQL Admin API version 2024-10, we're cleaning up the shopifyPaymentsAccount endpoint and removing several unused fields.

GraphQL API v2024-10 introduces FileSetInput for enhanced media handling in productSet. Replaces mediaIds and mediaId with files and file fields for better file management.

We are deprecating productChangeStatus mutation. Use...

GraphQL Admin API 2024-10 removes MetafieldStorefrontVisibility fields, queries, and mutations. Use MetafieldDefinition.access for enhanced flexibility and functionality.

GraphQL Admin API 2024-10 adds access argument for granular control in metafield mutations; deprecates visibleToStorefrontApi. Update your code to use access.

Admin API 2024-10 requires apps to have specific write scopes to release fulfillment holds. Insufficient access returns errors: INVALID_ACCESS in GraphQL, 422 in REST. Update scopes accordingly.

The 2024-10 update adds a category field to product create/update webhooks. Use API version 2024-10+ in your App Partner Dashboard to receive this data.

As of July 18, 2024, Shopify APIs support accurate refunds for orders with multiple shipping lines, detailing each refund in both GraphQL and REST APIs for improved data accuracy.

In the 2024-10 Admin GraphQL API, productDeleteAsync is removed. Use productDelete with a synchronous parameter to choose sync or async deletion, and track async status via operation ID.

In version 2024-10, the productDuplicateAsyncV2 mutation is removed. A new synchronous parameter in productDuplicate allows async duplication with operation tracking via ProductOperation.

GraphQL Admin API 2024-10 deprecates singular variant mutations in favor of bulk versions: use productVariantsBulkCreate, productVariantsBulkUpdate, and productVariantsBulkDelete instead.

As of the GraphQL Admin API version 2024-10, we're deprecating the GREATER_THAN_ZERO and INVALID_LINE_ITEM_QUANTITY error codes on the [fulfillmentOrderReleaseHold...

Added Product.restrictedForResource field to query product restrictions in CalculatedOrder, showing status and reason. Supports Managed Markets restrictions during order edits.

As of 2024-10, CartTransform create mutation supports metafields, enabling setting them at creation, reducing the need for additional calls, streamlining the process for developers.

As of Admin GraphQL API version 2024-10, we're deprecating the ability to set the available quantity on the InventoryActivate GraphQL mutation for already active states. Moving forward, use the...