11/21/2026, 12:01:20 AM
The API now includes a new mutation eventSubscriptionDelete that lets an authenticated app delete event subscriptions it created by handle. This mutation returns the handle of the deleted subscription and provides detailed errors, including NOT_FOUND when the subscription is not on the shop and INVALID_HANDLE for malformed handles. New types EventSubscriptionDeletePayload, EventSubscriptionDeleteUserError, and EventSubscriptionDeleteUserErrorCode support these results. The draftOrderCreate and draftOrderUpdate mutations have been updated to explicitly require the apply_discounts_to_draft_orders permission for adding or changing discounts. The abandonedCheckoutUrl field of AbandonedCheckout now requires access to all four protected customer fields; without that access the field (and sometimes the entire checkout) will be null and offline queries might return ACCESS_DENIED errors. Developers should request access to protected customer data if they need this URL or avoid the field to prevent data loss or API errors.
Deletes an event subscription that the authenticated app set on the shop with eventSubscriptionsSet,
matched by handle. A subscription the app's configuration declares is not set on the shop and can't be
deleted here.
Creates a draft order
with attributes such as customer information, line items, shipping and billing addresses, and payment terms.
Draft orders are useful for merchants that need to:
After creating a draft order, you can:
draftOrderInvoiceSend mutation.draftOrderComplete mutation.draftOrderUpdate mutation.draftOrderDuplicate mutation.draftOrderDelete mutation.Note:
When you create a draft order, you can't reserve or hold inventory for the items in the order by default.
However, you can reserve inventory using thereserveInventoryUntilinput.
A staff member needs the apply_discounts_to_draft_orders permission to add discounts.
Updates a draft order.
If a checkout has been started for a draft order, any update to the draft will unlink the checkout. Checkouts
are created but not immediately completed when opening the merchant credit card modal in the admin, and when a
buyer opens the invoice URL. This is usually fine, but there is an edge case where a checkout is in progress
and the draft is updated before the checkout completes. This will not interfere with the checkout and order
creation, but if the link from draft to checkout is broken the draft will remain open even after the order is
created.
A staff member needs the apply_discounts_to_draft_orders permission to add discounts.
Return type for eventSubscriptionDelete mutation.
An error that occurs during the execution of EventSubscriptionDelete.
Possible error codes that can be returned by EventSubscriptionDeleteUserError.
abandonedCheckoutUrl