4/11/2026, 12:00:51 AM
Merchant target queries and mutations were removed; merchants must now use the analyticsTarget endpoints. The analyticsTargetCreate and analyticsTargetUpdate mutations now take a single input object (AnalyticsTargetCreateInput / AnalyticsTargetUpdateInput) instead of individual scalar arguments, and the corresponding payload user errors are specialized. The analyticsTargets query added a name filter and changed its sortKey enumeration from MerchantTargetSortKeys to AnalyticsTargetSortKeys. Filtering on companies, giftCards, giftCardsCount, discountNodes, and discountNodesCount was expanded: companies gained an ordering_status filter, gift cards and discount nodes added customer_id/recipient_id and multiple tag support, and the gift card query now filters by balance status and initial value. New fields were added to existing types: CashDrawer now exposes a balance, Customer receives taxSettings, GiftCard has an optional lineItem, and StandardMetaobjectDefinitionTemplate includes an access configuration. Several enum values were added under catalog, fulfillment, and market error types, and a few values were removed from ShopifyPaymentsTransactionType. Finally, the DeliveryRateGroup id description was updated to clarify its global uniqueness.
A list of merchant targets for the shop.
A list of analytics targets for the shop.
A paginated list of companies in the shop. Company objects are business entities that purchase from the merchant.
Use the query argument to filter companies by attributes like name or externalId. Sort and paginate results to handle large datasets efficiently. Learn more about Shopify API search syntax.
Returns a list of discounts.
The total number of discounts for the shop. Limited to a maximum of 10000 by default.
Returns a paginated list of GiftCard objects issued for the shop.
You can filter gift cards by attributes such as status, last characters of the code, balance status, and other values using the query parameter. You can also apply SavedSearch objects to filter results.
The total number of gift cards issued for the shop. Limited to a maximum of 10000 by default.
Create a new merchant target.
Updates a merchant target.
Deletes one or more merchant targets.
Create a new analytics target.
Updates an analytics target.
The input fields for creating an analytics target.
An error that occurs during the execution of AnalyticsTargetCreate.
Possible error codes that can be returned by AnalyticsTargetCreateUserError.
The set of valid sort keys for the AnalyticsTarget query.
The input fields for updating an analytics target.
An error that occurs during the execution of AnalyticsTargetUpdate.
Possible error codes that can be returned by AnalyticsTargetUpdateUserError.
An error that occurs during the execution of AnalyticsTargetsDelete.
Possible error codes that can be returned by AnalyticsTargetsDeleteUserError.
Tax settings for a customer.
A merchant created target for an analytics metric.
An auto-generated type for paginating through multiple MerchantTargets.
Return type for merchantTargetCreate mutation.
An auto-generated type which holds one MerchantTarget and a cursor during pagination.
The set of valid sort keys for the MerchantTarget query.
Return type for merchantTargetUpdate mutation.
Return type for merchantTargetsDelete mutation.
userErrorsuserErrorsuserErrorsbalanceThe current balance in the cash drawer.
B2B_CATALOG_LIMIT_REACHEDUNPERMITTED_ENTITLEMENTS_DIRECT_CATALOG_ASSIGNMENTtaxSettingsThe customer's tax settings.
idRETURNING_TO_SENDERBUYER_ACTION_REQUIREDRETURNING_TO_SENDERBUYER_ACTION_REQUIREDlineItemThe line item from an order that initiated the creation of this gift card. This value is null if the gift card was issued manually.
CANNOT_ACTIVATE_MARKET_B2B_CATALOG_LIMIT_REACHEDB2B_CATALOG_LIMIT_REACHEDAGENTIC_FEE_TAX_DEBITAGENTIC_FEE_TAX_DEBIT_REVERSALAGENTIC_FEE_TAX_CREDITAGENTIC_FEE_TAX_CREDIT_REVERSALaccessAccess configuration for the standard metaobject definition template.