Add eventSubscriptionDelete and Draft Order Permission Note

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.

Mutation Changes

βž• Added Mutations (1)

eventSubscriptionDelete

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.

πŸ”„ Modified Mutations (2)

draftOrderCreate

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:

  • Create new orders for sales made by phone, in person, by chat, or elsewhere. When a merchant accepts payment for a draft order, an order is created.
  • Send invoices to customers with a secure checkout link.
  • Use custom items to represent additional costs or products not in inventory.
  • Re-create orders manually from active sales channels.
  • Sell products at discount or wholesale rates.
  • Take pre-orders.

After creating a draft order, you can:

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 the reserveInventoryUntil input.

A staff member needs the apply_discounts_to_draft_orders permission to add discounts.

draftOrderUpdate

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.

Type Changes

βž• Added Types (3)

πŸ—οΈEventSubscriptionDeletePayloadβž• AddedOBJECT

Return type for eventSubscriptionDelete mutation.

Fields: deletedEventSubscriptionHandle, userErrors
πŸ—οΈEventSubscriptionDeleteUserErrorβž• AddedOBJECT

An error that occurs during the execution of EventSubscriptionDelete.

Fields: code, field, message
πŸ“‹EventSubscriptionDeleteUserErrorCodeβž• AddedENUM

Possible error codes that can be returned by EventSubscriptionDeleteUserError.

Values: NOT_FOUND, INVALID_HANDLE

πŸ”„ Modified Types (1)

πŸ—οΈAbandonedCheckoutπŸ”„ Modified
πŸ”„ Field modified: abandonedCheckoutUrl