Choose a version:

Order

Requires one of the read_orders, read_marketplace_orders, read_buyer_membership_orders, or read_quick_sale access scopes.

Subscribe to field-level changes on the Order GraphQL Admin API object. You can subscribe to create, delete, and update events, as well as changes to specific fields.

Each topic corresponds to a commerce resource (for example, an order) that can exist independently within its domain. Child entities that depend on a parent within the same domain don't have their own topic. Instead, changes to child entities trigger a delivery on the parent topic. Calculated fields, derived fields, auto-updated timestamps, and cross-domain fields aren't available as triggers.

shopify.app.toml

[events]

api_version = "unstable"

[[events.subscription]]

handle = "my_order_events"

topic = "Order"

actions = ["update"]

triggers = [

"order.displayFulfillmentStatus"

]

uri = "https://your-app.com/events"

query = """

query order_details($orderId: ID!) {

order(id: $orderId) {

name

displayFinancialStatus

displayFulfillmentStatus

}

shop {

}

"""

Anchor to Supported triggersSupported triggers

Field-level triggers for Order subscriptions.

All triggers require one of the read_orders, read_marketplace_orders, read_buyer_membership_orders, or read_quick_sale access scopes, and those triggers that require additional scopes are documented where relevant. Deprecated triggers are listed last.

Subscriptions can include multiple triggers. Use the shopify-webhook-id header for deduplication when handling duplicate deliveries.

Custom queries aren't limited to Order. They can query the full GraphQL Admin API.

Anchor to list-of-topics-order.*

order.*

Fires when events involve the Order object, which represents a customer's request to purchase one or more products from a store.

The "create" and "delete" actions are only relevant within the context of this parent topic. Use fields_changed to follow or replicate impacted data after a delete event. Define a custom query to retrieve specific fields from create events.

order.* is a parent trigger. Subscribing with the "update" action receives events for all supported triggers under order, including nested triggers. Use a more specific trigger to limit events to the fields you need.

Variables: orderId

Anchor to list-of-topics-order.cancellation

order.cancellation

Fires when the cancellation field on the Order object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

Details of an order's cancellation, if it has been canceled.

Variables: orderId

Anchor to list-of-topics-order.customAttributes

order.customAttributes

Fires when the customAttributes field on the Order object changes.

The customAttributes field contains a list of additional information that has been attached to the order.

Variables: orderId

Anchor to list-of-topics-order.displayFinancialStatus

order.displayFinancialStatus

Fires when the displayFinancialStatus field on the Order object changes.

The displayFinancialStatus field represents an order's financial status for display in the Shopify admin.

Variables: orderId

Anchor to list-of-topics-order.email

order.email

Fires when the email field on the Order object changes.

The email field represents the email address associated with the customer for this order.

Variables: orderId

Anchor to list-of-topics-order.lineItems.*

order.lineItems.*

Fires when the lineItems field on the Order object changes.

order.lineItems.* is a parent trigger. Subscribing with the "update" action receives events for all supported triggers under order.lineItems, including nested triggers. Use a more specific trigger to limit events to the fields you need.

Include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The lineItems field contains a list of the order's line items.

Variables: lineItemsId, orderId

Anchor to list-of-topics-order.lineItems.currentQuantity

order.lineItems.currentQuantity

Fires when the currentQuantity field on the LineItem object changes.

The currentQuantity field represents the number of units ordered, excluding refunded and removed units.

Variables: lineItemsId, orderId

Anchor to list-of-topics-order.lineItems.customAttributes

order.lineItems.customAttributes

Fires when the customAttributes field on the LineItem object changes.

The customAttributes field contains a list of attributes that represent custom features or special requests.

Variables: lineItemsId, orderId

Anchor to list-of-topics-order.lineItems.discountedTotalSet.*

order.lineItems.discountedTotalSet.*

Fires when the discountedTotalSet field on the LineItem object changes.

order.lineItems.discountedTotalSet.* is a parent trigger. Subscribing with the "update" action receives events for all supported triggers under order.lineItems.discountedTotalSet, including nested triggers. Use a more specific trigger to limit events to the fields you need.

Include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The discountedTotalSet field represents the total discounted price of the line item in shop and presentment currencies, including refunded and removed quantities.

Variables: lineItemsId, orderId

Anchor to list-of-topics-order.lineItems.discountedTotalSet.presentmentMoney

order.lineItems.discountedTotalSet.presentmentMoney

Fires when the presentmentMoney field on the MoneyBag object changes.

Amount in presentment currency.

Variables: lineItemsId, orderId

Anchor to list-of-topics-order.lineItems.discountedTotalSet.shopMoney

order.lineItems.discountedTotalSet.shopMoney

Fires when the shopMoney field on the MoneyBag object changes.

Amount in shop currency.

Variables: lineItemsId, orderId

Anchor to list-of-topics-order.lineItems.discountedUnitPriceAfterAllDiscountsSet.*

order.lineItems.discountedUnitPriceAfterAllDiscountsSet.*

Fires when the discountedUnitPriceAfterAllDiscountsSet field on the LineItem object changes.

order.lineItems.discountedUnitPriceAfterAllDiscountsSet.* is a parent trigger. Subscribing with the "update" action receives events for all supported triggers under order.lineItems.discountedUnitPriceAfterAllDiscountsSet, including nested triggers. Use a more specific trigger to limit events to the fields you need.

Include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The discountedUnitPriceAfterAllDiscountsSet field represents the approximate unit price of the line item in shop and presentment currencies.

Variables: lineItemsId, orderId

Anchor to list-of-topics-order.lineItems.discountedUnitPriceAfterAllDiscountsSet.presentmentMoney

order.lineItems.discountedUnitPriceAfterAllDiscountsSet.presentmentMoney

Fires when the presentmentMoney field on the MoneyBag object changes.

Amount in presentment currency.

Variables: lineItemsId, orderId

Anchor to list-of-topics-order.lineItems.discountedUnitPriceAfterAllDiscountsSet.shopMoney

order.lineItems.discountedUnitPriceAfterAllDiscountsSet.shopMoney

Fires when the shopMoney field on the MoneyBag object changes.

Amount in shop currency.

Variables: lineItemsId, orderId

Anchor to list-of-topics-order.lineItems.duties

order.lineItems.duties

Fires when the duties field on the LineItem object changes.

The duties field represents the duties associated with the line item.

Variables: dutiesId, lineItemsId, orderId

Anchor to list-of-topics-order.lineItems.merchantEditable

order.lineItems.merchantEditable

Fires when the merchantEditable field on the LineItem object changes.

The merchantEditable field indicates whether the line item can be edited or not.

Variables: lineItemsId, orderId

Anchor to list-of-topics-order.lineItems.originalTotalSet.*

order.lineItems.originalTotalSet.*

Fires when the originalTotalSet field on the LineItem object changes.

order.lineItems.originalTotalSet.* is a parent trigger. Subscribing with the "update" action receives events for all supported triggers under order.lineItems.originalTotalSet, including nested triggers. Use a more specific trigger to limit events to the fields you need.

Include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

In shop and presentment currencies, the total price of the line item when the order was created.

Variables: lineItemsId, orderId

Anchor to list-of-topics-order.lineItems.originalTotalSet.presentmentMoney

order.lineItems.originalTotalSet.presentmentMoney

Fires when the presentmentMoney field on the MoneyBag object changes.

Amount in presentment currency.

Variables: lineItemsId, orderId

Anchor to list-of-topics-order.lineItems.originalTotalSet.shopMoney

order.lineItems.originalTotalSet.shopMoney

Fires when the shopMoney field on the MoneyBag object changes.

Amount in shop currency.

Variables: lineItemsId, orderId

Anchor to list-of-topics-order.lineItems.priceAfterAllDiscountsBeforeTaxesSet.*

order.lineItems.priceAfterAllDiscountsBeforeTaxesSet.*

Fires when the priceAfterAllDiscountsBeforeTaxesSet field on the LineItem object changes.

order.lineItems.priceAfterAllDiscountsBeforeTaxesSet.* is a parent trigger. Subscribing with the "update" action receives events for all supported triggers under order.lineItems.priceAfterAllDiscountsBeforeTaxesSet, including nested triggers. Use a more specific trigger to limit events to the fields you need.

Include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The priceAfterAllDiscountsBeforeTaxesSet field represents the total price of the line item in shop and presentment currencies, after all discounts are applied and excluding refunded and removed quantities.

Variables: lineItemsId, orderId

Anchor to list-of-topics-order.lineItems.priceAfterAllDiscountsBeforeTaxesSet.presentmentMoney

order.lineItems.priceAfterAllDiscountsBeforeTaxesSet.presentmentMoney

Fires when the presentmentMoney field on the MoneyBag object changes.

Amount in presentment currency.

Variables: lineItemsId, orderId

Anchor to list-of-topics-order.lineItems.priceAfterAllDiscountsBeforeTaxesSet.shopMoney

order.lineItems.priceAfterAllDiscountsBeforeTaxesSet.shopMoney

Fires when the shopMoney field on the MoneyBag object changes.

Amount in shop currency.

Variables: lineItemsId, orderId

Anchor to list-of-topics-order.lineItems.quantity

order.lineItems.quantity

Fires when the quantity field on the LineItem object changes.

The quantity field represents the number of units ordered, including refunded and removed units.

Variables: lineItemsId, orderId

Anchor to list-of-topics-order.lineItems.taxLines

order.lineItems.taxLines

Fires when the taxLines field on the LineItem object changes.

The taxLines field represents the taxes charged for the line item, including taxes charged for refunded and removed quantities.

Variables: lineItemsId, orderId

Anchor to list-of-topics-order.metafield(namespace: String!, key: String!).*

order.metafield(namespace: String!, key: String!).*

Fires when the metafield field on the Order object changes.

order.metafield(namespace: String!, key: String!).* is a parent trigger. Subscribing with the "update" action receives events for all supported triggers under order.metafield(namespace: String!, key: String!), including nested triggers. Use a more specific trigger to limit events to the fields you need.

Include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The metafield field represents a custom field, including its namespace and key, that's associated with a Shopify resource for the purposes of adding and storing additional information.

Variables: metafieldKey, metafieldNamespace, orderId

Anchor to list-of-topics-order.metafield(namespace: String!).*

order.metafield(namespace: String!).*

Fires when the metafield field on the Order object changes.

order.metafield(namespace: String!).* is a parent trigger. Subscribing with the "update" action receives events for all supported triggers under order.metafield(namespace: String!), including nested triggers. Use a more specific trigger to limit events to the fields you need.

Include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

This subscription omits the optional argument metafield.key.

The metafield field represents a custom field, including its namespace and key, that's associated with a Shopify resource for the purposes of adding and storing additional information.

Variables: metafieldKey, metafieldNamespace, orderId

Anchor to list-of-topics-order.metafield(namespace: String!, key: String!).value

order.metafield(namespace: String!, key: String!).value

Fires when the value field on the Metafield object changes.

The value field represents the data stored in the metafield.

Variables: metafieldKey, metafieldNamespace, orderId

Anchor to list-of-topics-order.metafield(namespace: String!).value

order.metafield(namespace: String!).value

Fires when the value field on the Metafield object changes.

This subscription omits the optional argument metafield.key.

The value field represents the data stored in the metafield.

Variables: metafieldKey, metafieldNamespace, orderId

Anchor to list-of-topics-order.note

order.note

Fires when the note field on the Order object changes.

The note field represents the note associated with the order.

Variables: orderId

Anchor to list-of-topics-order.phone

order.phone

Fires when the phone field on the Order object changes.

The phone field represents the phone number associated with the customer for this order.

Variables: orderId

Anchor to list-of-topics-order.shippingLines

order.shippingLines

Fires when the shippingLines field on the Order object changes.

The shippingLines field represents the shipping methods applied to the order.

Variables: orderId, shippingLinesId

Anchor to list-of-topics-order.subtotalPriceSet.*

order.subtotalPriceSet.*

Fires when the subtotalPriceSet field on the Order object changes.

order.subtotalPriceSet.* is a parent trigger. Subscribing with the "update" action receives events for all supported triggers under order.subtotalPriceSet, including nested triggers. Use a more specific trigger to limit events to the fields you need.

Include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The subtotalPriceSet field represents the sum of the prices for all line items after discounts and before returns, in shop and presentment currencies.

Variables: orderId

Anchor to list-of-topics-order.subtotalPriceSet.presentmentMoney

order.subtotalPriceSet.presentmentMoney

Fires when the presentmentMoney field on the MoneyBag object changes.

Amount in presentment currency.

Variables: orderId

Anchor to list-of-topics-order.subtotalPriceSet.shopMoney

order.subtotalPriceSet.shopMoney

Fires when the shopMoney field on the MoneyBag object changes.

Amount in shop currency.

Variables: orderId

Anchor to list-of-topics-order.tags

order.tags

Fires when the tags field on the Order object changes.

The tags field represents a comma separated list of tags associated with the order.

Variables: orderId

Anchor to list-of-topics-order.totalCapturableSet.*

order.totalCapturableSet.*

Fires when the totalCapturableSet field on the Order object changes.

order.totalCapturableSet.* is a parent trigger. Subscribing with the "update" action receives events for all supported triggers under order.totalCapturableSet, including nested triggers. Use a more specific trigger to limit events to the fields you need.

Include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The totalCapturableSet field represents the authorized amount that's uncaptured or undercaptured, in shop and presentment currencies.

Variables: orderId

Anchor to list-of-topics-order.totalCapturableSet.presentmentMoney

order.totalCapturableSet.presentmentMoney

Fires when the presentmentMoney field on the MoneyBag object changes.

Amount in presentment currency.

Variables: orderId

Anchor to list-of-topics-order.totalCapturableSet.shopMoney

order.totalCapturableSet.shopMoney

Fires when the shopMoney field on the MoneyBag object changes.

Amount in shop currency.

Variables: orderId

Anchor to list-of-topics-order.totalDiscountsSet.*

order.totalDiscountsSet.*

Fires when the totalDiscountsSet field on the Order object changes.

order.totalDiscountsSet.* is a parent trigger. Subscribing with the "update" action receives events for all supported triggers under order.totalDiscountsSet, including nested triggers. Use a more specific trigger to limit events to the fields you need.

Include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The totalDiscountsSet field represents the total amount discounted on the order before returns, in shop and presentment currencies.

Variables: orderId

Anchor to list-of-topics-order.totalDiscountsSet.presentmentMoney

order.totalDiscountsSet.presentmentMoney

Fires when the presentmentMoney field on the MoneyBag object changes.

Amount in presentment currency.

Variables: orderId

Anchor to list-of-topics-order.totalDiscountsSet.shopMoney

order.totalDiscountsSet.shopMoney

Fires when the shopMoney field on the MoneyBag object changes.

Amount in shop currency.

Variables: orderId

Anchor to list-of-topics-order.totalPriceSet.*

order.totalPriceSet.*

Fires when the totalPriceSet field on the Order object changes.

order.totalPriceSet.* is a parent trigger. Subscribing with the "update" action receives events for all supported triggers under order.totalPriceSet, including nested triggers. Use a more specific trigger to limit events to the fields you need.

Include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The totalPriceSet field represents the total price of the order, before returns, in shop and presentment currencies.

Variables: orderId

Anchor to list-of-topics-order.totalPriceSet.presentmentMoney

order.totalPriceSet.presentmentMoney

Fires when the presentmentMoney field on the MoneyBag object changes.

Amount in presentment currency.

Variables: orderId

Anchor to list-of-topics-order.totalPriceSet.shopMoney

order.totalPriceSet.shopMoney

Fires when the shopMoney field on the MoneyBag object changes.

Amount in shop currency.

Variables: orderId

Anchor to list-of-topics-order.totalReceivedSet.*

order.totalReceivedSet.*

Fires when the totalReceivedSet field on the Order object changes.

order.totalReceivedSet.* is a parent trigger. Subscribing with the "update" action receives events for all supported triggers under order.totalReceivedSet, including nested triggers. Use a more specific trigger to limit events to the fields you need.

Include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The totalReceivedSet field represents the total amount received from the customer before returns, in shop and presentment currencies.

Variables: orderId

Anchor to list-of-topics-order.totalReceivedSet.presentmentMoney

order.totalReceivedSet.presentmentMoney

Fires when the presentmentMoney field on the MoneyBag object changes.

Amount in presentment currency.

Variables: orderId

Anchor to list-of-topics-order.totalReceivedSet.shopMoney

order.totalReceivedSet.shopMoney

Fires when the shopMoney field on the MoneyBag object changes.

Amount in shop currency.

Variables: orderId

Anchor to list-of-topics-order.totalRefundedSet.*

order.totalRefundedSet.*

Fires when the totalRefundedSet field on the Order object changes.

order.totalRefundedSet.* is a parent trigger. Subscribing with the "update" action receives events for all supported triggers under order.totalRefundedSet, including nested triggers. Use a more specific trigger to limit events to the fields you need.

Include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The totalRefundedSet field represents the total amount that was refunded, in shop and presentment currencies.

Variables: orderId

Anchor to list-of-topics-order.totalRefundedSet.presentmentMoney

order.totalRefundedSet.presentmentMoney

Fires when the presentmentMoney field on the MoneyBag object changes.

Amount in presentment currency.

Variables: orderId

Anchor to list-of-topics-order.totalRefundedSet.shopMoney

order.totalRefundedSet.shopMoney

Fires when the shopMoney field on the MoneyBag object changes.

Amount in shop currency.

Variables: orderId

Anchor to list-of-topics-order.totalRefundedShippingSet.*

order.totalRefundedShippingSet.*

Fires when the totalRefundedShippingSet field on the Order object changes.

order.totalRefundedShippingSet.* is a parent trigger. Subscribing with the "update" action receives events for all supported triggers under order.totalRefundedShippingSet, including nested triggers. Use a more specific trigger to limit events to the fields you need.

Include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The totalRefundedShippingSet field represents the total amount of shipping that was refunded, in shop and presentment currencies.

Variables: orderId

Anchor to list-of-topics-order.totalRefundedShippingSet.presentmentMoney

order.totalRefundedShippingSet.presentmentMoney

Fires when the presentmentMoney field on the MoneyBag object changes.

Amount in presentment currency.

Variables: orderId

Anchor to list-of-topics-order.totalRefundedShippingSet.shopMoney

order.totalRefundedShippingSet.shopMoney

Fires when the shopMoney field on the MoneyBag object changes.

Amount in shop currency.

Variables: orderId

Anchor to list-of-topics-order.totalShippingPriceSet.*

order.totalShippingPriceSet.*

Fires when the totalShippingPriceSet field on the Order object changes.

order.totalShippingPriceSet.* is a parent trigger. Subscribing with the "update" action receives events for all supported triggers under order.totalShippingPriceSet, including nested triggers. Use a more specific trigger to limit events to the fields you need.

Include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The totalShippingPriceSet field represents the total shipping costs returned to the customer, in shop and presentment currencies.

Variables: orderId

Anchor to list-of-topics-order.totalShippingPriceSet.presentmentMoney

order.totalShippingPriceSet.presentmentMoney

Fires when the presentmentMoney field on the MoneyBag object changes.

Amount in presentment currency.

Variables: orderId

Anchor to list-of-topics-order.totalShippingPriceSet.shopMoney

order.totalShippingPriceSet.shopMoney

Fires when the shopMoney field on the MoneyBag object changes.

Amount in shop currency.

Variables: orderId

Anchor to list-of-topics-order.totalTaxSet.*

order.totalTaxSet.*

Fires when the totalTaxSet field on the Order object changes.

order.totalTaxSet.* is a parent trigger. Subscribing with the "update" action receives events for all supported triggers under order.totalTaxSet, including nested triggers. Use a more specific trigger to limit events to the fields you need.

Include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The totalTaxSet field represents the total tax amount before returns, in shop and presentment currencies.

Variables: orderId

Anchor to list-of-topics-order.totalTaxSet.presentmentMoney

order.totalTaxSet.presentmentMoney

Fires when the presentmentMoney field on the MoneyBag object changes.

Amount in presentment currency.

Variables: orderId

Anchor to list-of-topics-order.totalTaxSet.shopMoney

order.totalTaxSet.shopMoney

Fires when the shopMoney field on the MoneyBag object changes.

Amount in shop currency.

Variables: orderId

Anchor to list-of-topics-order.totalTipReceivedSet.*

order.totalTipReceivedSet.*

Fires when the totalTipReceivedSet field on the Order object changes.

order.totalTipReceivedSet.* is a parent trigger. Subscribing with the "update" action receives events for all supported triggers under order.totalTipReceivedSet, including nested triggers. Use a more specific trigger to limit events to the fields you need.

Include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The totalTipReceivedSet field represents the sum of all tip amounts for the order, in shop and presentment currencies.

Variables: orderId

Anchor to list-of-topics-order.totalTipReceivedSet.presentmentMoney

order.totalTipReceivedSet.presentmentMoney

Fires when the presentmentMoney field on the MoneyBag object changes.

Amount in presentment currency.

Variables: orderId

Anchor to list-of-topics-order.totalTipReceivedSet.shopMoney

order.totalTipReceivedSet.shopMoney

Fires when the shopMoney field on the MoneyBag object changes.

Amount in shop currency.

Variables: orderId

Subscribe via app configuration

[events]

api_version = "unstable"

[[events.subscription]]

handle = "order-event"

topic = "Order"

actions = ["create","update","delete"]

triggers = ["order.*"]

uri = "https://your-app.com/events"

query = """

query order_details($orderId: ID!) {

order(id: $orderId) {

name

displayFinancialStatus

displayFulfillmentStatus

}

"""

Examples

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["create","update","delete"]
triggers = ["order.*"]

uri = "https://your-app.com/events"

query = """
query order_details($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
  }
}
"""

Payload (added)

{
  "topic": "Order",
  "action": "create",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED"
    }
  },
  "fields_changed": {
    "added": [
      "order[id: 'gid://shopify/Order/5170247382690']"
    ],
    "updated": [],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Payload (updated)

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED"
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].cancellation"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Payload (removed)

{
  "topic": "Order",
  "action": "delete",
  "handle": "order-event",
  "data": {
    "order": null
  },
  "fields_changed": {
    "added": [],
    "updated": [],
    "removed": [
      "order[id: 'gid://shopify/Order/5170247382690']"
    ]
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update # or create, delete
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.cancellation"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    cancellation {
      __typename
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "cancellation": {
        "__typename": "OrderCancellation"
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].cancellation"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.customAttributes"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    customAttributes {
      __typename
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "customAttributes": [
        {
          "__typename": "Attribute"
        }
      ]
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].customAttributes"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.displayFinancialStatus"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED"
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].displayFinancialStatus"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.email"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    email
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "email": "customer@example.com"
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].email"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.lineItems.*"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    lineItems(first: 10) {
      nodes {
        id
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "lineItems": {
        "nodes": [
          {
            "id": "gid://shopify/LineItem/2472588472838"
          }
        ]
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].lineItems[id: 'gid://shopify/LineItem/2472588472838'].currentQuantity"
    ],
    "removed": []
  },
  "query_variables": {
    "lineItemsId": "gid://shopify/LineItem/2472588472838",
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.lineItems.currentQuantity"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    lineItems(first: 10) {
      nodes {
        currentQuantity
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "lineItems": {
        "nodes": [
          {
            "currentQuantity": "…"
          }
        ]
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].lineItems[id: 'gid://shopify/LineItem/2472588472838'].currentQuantity"
    ],
    "removed": []
  },
  "query_variables": {
    "lineItemsId": "gid://shopify/LineItem/2472588472838",
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.lineItems.customAttributes"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    lineItems(first: 10) {
      nodes {
        customAttributes {
          __typename
        }
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "lineItems": {
        "nodes": [
          {
            "customAttributes": [
              {
                "__typename": "Attribute"
              }
            ]
          }
        ]
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].lineItems[id: 'gid://shopify/LineItem/2472588472838'].customAttributes"
    ],
    "removed": []
  },
  "query_variables": {
    "lineItemsId": "gid://shopify/LineItem/2472588472838",
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.lineItems.discountedTotalSet.*"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    lineItems(first: 10) {
      nodes {
        discountedTotalSet {
          __typename
        }
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "lineItems": {
        "nodes": [
          {
            "discountedTotalSet": {
              "__typename": "MoneyBag"
            }
          }
        ]
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].lineItems[id: 'gid://shopify/LineItem/2472588472838'].discountedTotalSet.presentmentMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "lineItemsId": "gid://shopify/LineItem/2472588472838",
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.lineItems.discountedTotalSet.presentmentMoney"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    lineItems(first: 10) {
      nodes {
        discountedTotalSet {
          presentmentMoney {
            __typename
          }
        }
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "lineItems": {
        "nodes": [
          {
            "discountedTotalSet": {
              "presentmentMoney": {
                "__typename": "MoneyV2"
              }
            }
          }
        ]
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].lineItems[id: 'gid://shopify/LineItem/2472588472838'].discountedTotalSet.presentmentMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "lineItemsId": "gid://shopify/LineItem/2472588472838",
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.lineItems.discountedTotalSet.shopMoney"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    lineItems(first: 10) {
      nodes {
        discountedTotalSet {
          shopMoney {
            __typename
          }
        }
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "lineItems": {
        "nodes": [
          {
            "discountedTotalSet": {
              "shopMoney": {
                "__typename": "MoneyV2"
              }
            }
          }
        ]
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].lineItems[id: 'gid://shopify/LineItem/2472588472838'].discountedTotalSet.shopMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "lineItemsId": "gid://shopify/LineItem/2472588472838",
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.lineItems.discountedUnitPriceAfterAllDiscountsSet.*"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    lineItems(first: 10) {
      nodes {
        discountedUnitPriceAfterAllDiscountsSet {
          __typename
        }
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "lineItems": {
        "nodes": [
          {
            "discountedUnitPriceAfterAllDiscountsSet": {
              "__typename": "MoneyBag"
            }
          }
        ]
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].lineItems[id: 'gid://shopify/LineItem/2472588472838'].discountedUnitPriceAfterAllDiscountsSet.presentmentMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "lineItemsId": "gid://shopify/LineItem/2472588472838",
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.lineItems.discountedUnitPriceAfterAllDiscountsSet.presentmentMoney"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    lineItems(first: 10) {
      nodes {
        discountedUnitPriceAfterAllDiscountsSet {
          presentmentMoney {
            __typename
          }
        }
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "lineItems": {
        "nodes": [
          {
            "discountedUnitPriceAfterAllDiscountsSet": {
              "presentmentMoney": {
                "__typename": "MoneyV2"
              }
            }
          }
        ]
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].lineItems[id: 'gid://shopify/LineItem/2472588472838'].discountedUnitPriceAfterAllDiscountsSet.presentmentMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "lineItemsId": "gid://shopify/LineItem/2472588472838",
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.lineItems.discountedUnitPriceAfterAllDiscountsSet.shopMoney"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    lineItems(first: 10) {
      nodes {
        discountedUnitPriceAfterAllDiscountsSet {
          shopMoney {
            __typename
          }
        }
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "lineItems": {
        "nodes": [
          {
            "discountedUnitPriceAfterAllDiscountsSet": {
              "shopMoney": {
                "__typename": "MoneyV2"
              }
            }
          }
        ]
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].lineItems[id: 'gid://shopify/LineItem/2472588472838'].discountedUnitPriceAfterAllDiscountsSet.shopMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "lineItemsId": "gid://shopify/LineItem/2472588472838",
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.lineItems.duties"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    lineItems(first: 10) {
      nodes {
        duties {
          id
        }
      }
    }
  }
}
"""

Payload (added)

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "lineItems": {
        "nodes": [
          {
            "duties": [
              {
                "id": "gid://shopify/Duty/5204645307575"
              }
            ]
          }
        ]
      }
    }
  },
  "fields_changed": {
    "added": [
      "order[id: 'gid://shopify/Order/5170247382690'].lineItems[id: 'gid://shopify/LineItem/2472588472838'].duties[id: 'gid://shopify/Duty/5204645307575']"
    ],
    "updated": [],
    "removed": []
  },
  "query_variables": {
    "dutiesId": "gid://shopify/Duty/5204645307575",
    "lineItemsId": "gid://shopify/LineItem/2472588472838",
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Payload (removed)

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "lineItems": {
        "nodes": [
          {
            "duties": [
              {
                "id": "gid://shopify/Duty/111"
              }
            ]
          }
        ]
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [],
    "removed": [
      "order[id: 'gid://shopify/Order/5170247382690'].lineItems[id: 'gid://shopify/LineItem/2472588472838'].duties[id: 'gid://shopify/Duty/5204645307575']"
    ]
  },
  "query_variables": {
    "dutiesId": "gid://shopify/Duty/5204645307575",
    "lineItemsId": "gid://shopify/LineItem/2472588472838",
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.lineItems.merchantEditable"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    lineItems(first: 10) {
      nodes {
        merchantEditable
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "lineItems": {
        "nodes": [
          {
            "merchantEditable": "…"
          }
        ]
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].lineItems[id: 'gid://shopify/LineItem/2472588472838'].merchantEditable"
    ],
    "removed": []
  },
  "query_variables": {
    "lineItemsId": "gid://shopify/LineItem/2472588472838",
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.lineItems.originalTotalSet.*"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    lineItems(first: 10) {
      nodes {
        originalTotalSet {
          __typename
        }
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "lineItems": {
        "nodes": [
          {
            "originalTotalSet": {
              "__typename": "MoneyBag"
            }
          }
        ]
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].lineItems[id: 'gid://shopify/LineItem/2472588472838'].originalTotalSet.presentmentMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "lineItemsId": "gid://shopify/LineItem/2472588472838",
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.lineItems.originalTotalSet.presentmentMoney"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    lineItems(first: 10) {
      nodes {
        originalTotalSet {
          presentmentMoney {
            __typename
          }
        }
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "lineItems": {
        "nodes": [
          {
            "originalTotalSet": {
              "presentmentMoney": {
                "__typename": "MoneyV2"
              }
            }
          }
        ]
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].lineItems[id: 'gid://shopify/LineItem/2472588472838'].originalTotalSet.presentmentMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "lineItemsId": "gid://shopify/LineItem/2472588472838",
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.lineItems.originalTotalSet.shopMoney"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    lineItems(first: 10) {
      nodes {
        originalTotalSet {
          shopMoney {
            __typename
          }
        }
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "lineItems": {
        "nodes": [
          {
            "originalTotalSet": {
              "shopMoney": {
                "__typename": "MoneyV2"
              }
            }
          }
        ]
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].lineItems[id: 'gid://shopify/LineItem/2472588472838'].originalTotalSet.shopMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "lineItemsId": "gid://shopify/LineItem/2472588472838",
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.lineItems.priceAfterAllDiscountsBeforeTaxesSet.*"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    lineItems(first: 10) {
      nodes {
        priceAfterAllDiscountsBeforeTaxesSet {
          __typename
        }
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "lineItems": {
        "nodes": [
          {
            "priceAfterAllDiscountsBeforeTaxesSet": {
              "__typename": "MoneyBag"
            }
          }
        ]
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].lineItems[id: 'gid://shopify/LineItem/2472588472838'].priceAfterAllDiscountsBeforeTaxesSet.presentmentMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "lineItemsId": "gid://shopify/LineItem/2472588472838",
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.lineItems.priceAfterAllDiscountsBeforeTaxesSet.presentmentMoney"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    lineItems(first: 10) {
      nodes {
        priceAfterAllDiscountsBeforeTaxesSet {
          presentmentMoney {
            __typename
          }
        }
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "lineItems": {
        "nodes": [
          {
            "priceAfterAllDiscountsBeforeTaxesSet": {
              "presentmentMoney": {
                "__typename": "MoneyV2"
              }
            }
          }
        ]
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].lineItems[id: 'gid://shopify/LineItem/2472588472838'].priceAfterAllDiscountsBeforeTaxesSet.presentmentMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "lineItemsId": "gid://shopify/LineItem/2472588472838",
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.lineItems.priceAfterAllDiscountsBeforeTaxesSet.shopMoney"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    lineItems(first: 10) {
      nodes {
        priceAfterAllDiscountsBeforeTaxesSet {
          shopMoney {
            __typename
          }
        }
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "lineItems": {
        "nodes": [
          {
            "priceAfterAllDiscountsBeforeTaxesSet": {
              "shopMoney": {
                "__typename": "MoneyV2"
              }
            }
          }
        ]
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].lineItems[id: 'gid://shopify/LineItem/2472588472838'].priceAfterAllDiscountsBeforeTaxesSet.shopMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "lineItemsId": "gid://shopify/LineItem/2472588472838",
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.lineItems.quantity"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    lineItems(first: 10) {
      nodes {
        quantity
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "lineItems": {
        "nodes": [
          {
            "quantity": "…"
          }
        ]
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].lineItems[id: 'gid://shopify/LineItem/2472588472838'].quantity"
    ],
    "removed": []
  },
  "query_variables": {
    "lineItemsId": "gid://shopify/LineItem/2472588472838",
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.lineItems.taxLines"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    lineItems(first: 10) {
      nodes {
        taxLines(first: 10) {
          __typename
        }
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "lineItems": {
        "nodes": [
          {
            "taxLines": [
              {
                "__typename": "TaxLine"
              }
            ]
          }
        ]
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].lineItems[id: 'gid://shopify/LineItem/2472588472838'].taxLines"
    ],
    "removed": []
  },
  "query_variables": {
    "lineItemsId": "gid://shopify/LineItem/2472588472838",
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.metafield(namespace: 'custom', key: 'rating').*"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!, $metafieldNamespace: String!, $metafieldKey: String!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    metafield(namespace: $metafieldNamespace, key: $metafieldKey) {
      namespace
      key
      value
      type
    }
  }
}
"""

Payload (added)

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "metafield": {
        "namespace": "custom",
        "key": "rating",
        "value": "Cotton",
        "type": "single_line_text_field"
      }
    }
  },
  "fields_changed": {
    "added": [
      "order[id: 'gid://shopify/Order/5170247382690'].metafield[namespace: 'custom', key: 'rating']"
    ],
    "updated": [],
    "removed": []
  },
  "query_variables": {
    "metafieldKey": "rating",
    "metafieldNamespace": "custom",
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Payload (removed)

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "metafield": {
        "namespace": "custom",
        "key": "rating",
        "value": "Cotton",
        "type": "single_line_text_field"
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [],
    "removed": [
      "order[id: 'gid://shopify/Order/5170247382690'].metafield[namespace: 'custom', key: 'rating']"
    ]
  },
  "query_variables": {
    "metafieldKey": "rating",
    "metafieldNamespace": "custom",
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.metafield(namespace: 'custom').*"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!, $metafieldNamespace: String!, $metafieldKey: String!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    metafield(namespace: $metafieldNamespace, key: $metafieldKey) {
      namespace
      key
      value
      type
    }
  }
}
"""

Payload (added)

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "metafield": {
        "namespace": "custom",
        "key": "rating",
        "value": "Cotton",
        "type": "single_line_text_field"
      }
    }
  },
  "fields_changed": {
    "added": [
      "order[id: 'gid://shopify/Order/5170247382690'].metafield[namespace: 'custom', key: 'rating']"
    ],
    "updated": [],
    "removed": []
  },
  "query_variables": {
    "metafieldKey": "rating",
    "metafieldNamespace": "custom",
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Payload (removed)

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "metafield": {
        "namespace": "custom",
        "key": "rating",
        "value": "Cotton",
        "type": "single_line_text_field"
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [],
    "removed": [
      "order[id: 'gid://shopify/Order/5170247382690'].metafield[namespace: 'custom', key: 'rating']"
    ]
  },
  "query_variables": {
    "metafieldKey": "rating",
    "metafieldNamespace": "custom",
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.metafield(namespace: 'custom', key: 'rating').value"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!, $metafieldNamespace: String!, $metafieldKey: String!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    metafield(namespace: $metafieldNamespace, key: $metafieldKey) {
      namespace
      key
      value
      type
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "metafield": {
        "namespace": "custom",
        "key": "rating",
        "value": "Cotton",
        "type": "single_line_text_field"
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].metafield[namespace: 'custom', key: 'rating'].value"
    ],
    "removed": []
  },
  "query_variables": {
    "metafieldKey": "rating",
    "metafieldNamespace": "custom",
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.metafield(namespace: 'custom').value"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!, $metafieldNamespace: String!, $metafieldKey: String!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    metafield(namespace: $metafieldNamespace, key: $metafieldKey) {
      namespace
      key
      value
      type
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "metafield": {
        "namespace": "custom",
        "key": "rating",
        "value": "Cotton",
        "type": "single_line_text_field"
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].metafield[namespace: 'custom', key: 'rating'].value"
    ],
    "removed": []
  },
  "query_variables": {
    "metafieldKey": "rating",
    "metafieldNamespace": "custom",
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.note"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    note
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "note": "…"
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].note"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.phone"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    phone
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "phone": "…"
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].phone"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.shippingLines"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    shippingLines(first: 10) {
      nodes {
        id
      }
    }
  }
}
"""

Payload (added)

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "shippingLines": {
        "nodes": [
          {
            "id": "gid://shopify/ShippingLine/1801163870742"
          }
        ]
      }
    }
  },
  "fields_changed": {
    "added": [
      "order[id: 'gid://shopify/Order/5170247382690'].shippingLines[id: 'gid://shopify/ShippingLine/1801163870742']"
    ],
    "updated": [],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690",
    "shippingLinesId": "gid://shopify/ShippingLine/1801163870742"
  }
}

Payload (removed)

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "shippingLines": {
        "nodes": [
          {
            "id": "gid://shopify/ShippingLine/111"
          }
        ]
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [],
    "removed": [
      "order[id: 'gid://shopify/Order/5170247382690'].shippingLines[id: 'gid://shopify/ShippingLine/1801163870742']"
    ]
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690",
    "shippingLinesId": "gid://shopify/ShippingLine/1801163870742"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.subtotalPriceSet.*"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    subtotalPriceSet {
      __typename
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "subtotalPriceSet": {
        "__typename": "MoneyBag"
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].subtotalPriceSet.presentmentMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.subtotalPriceSet.presentmentMoney"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    subtotalPriceSet {
      presentmentMoney {
        __typename
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "subtotalPriceSet": {
        "presentmentMoney": {
          "__typename": "MoneyV2"
        }
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].subtotalPriceSet.presentmentMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.subtotalPriceSet.shopMoney"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    subtotalPriceSet {
      shopMoney {
        __typename
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "subtotalPriceSet": {
        "shopMoney": {
          "__typename": "MoneyV2"
        }
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].subtotalPriceSet.shopMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.tags"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    tags
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "tags": [
        "…"
      ]
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].tags"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.totalCapturableSet.*"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    totalCapturableSet {
      __typename
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "totalCapturableSet": {
        "__typename": "MoneyBag"
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].totalCapturableSet.presentmentMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.totalCapturableSet.presentmentMoney"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    totalCapturableSet {
      presentmentMoney {
        __typename
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "totalCapturableSet": {
        "presentmentMoney": {
          "__typename": "MoneyV2"
        }
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].totalCapturableSet.presentmentMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.totalCapturableSet.shopMoney"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    totalCapturableSet {
      shopMoney {
        __typename
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "totalCapturableSet": {
        "shopMoney": {
          "__typename": "MoneyV2"
        }
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].totalCapturableSet.shopMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.totalDiscountsSet.*"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    totalDiscountsSet {
      __typename
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "totalDiscountsSet": {
        "__typename": "MoneyBag"
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].totalDiscountsSet.presentmentMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.totalDiscountsSet.presentmentMoney"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    totalDiscountsSet {
      presentmentMoney {
        __typename
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "totalDiscountsSet": {
        "presentmentMoney": {
          "__typename": "MoneyV2"
        }
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].totalDiscountsSet.presentmentMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.totalDiscountsSet.shopMoney"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    totalDiscountsSet {
      shopMoney {
        __typename
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "totalDiscountsSet": {
        "shopMoney": {
          "__typename": "MoneyV2"
        }
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].totalDiscountsSet.shopMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.totalPriceSet.*"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    totalPriceSet {
      __typename
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "totalPriceSet": {
        "__typename": "MoneyBag"
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].totalPriceSet.presentmentMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.totalPriceSet.presentmentMoney"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    totalPriceSet {
      presentmentMoney {
        __typename
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "totalPriceSet": {
        "presentmentMoney": {
          "__typename": "MoneyV2"
        }
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].totalPriceSet.presentmentMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.totalPriceSet.shopMoney"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    totalPriceSet {
      shopMoney {
        __typename
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "totalPriceSet": {
        "shopMoney": {
          "__typename": "MoneyV2"
        }
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].totalPriceSet.shopMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.totalReceivedSet.*"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    totalReceivedSet {
      __typename
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "totalReceivedSet": {
        "__typename": "MoneyBag"
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].totalReceivedSet.presentmentMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.totalReceivedSet.presentmentMoney"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    totalReceivedSet {
      presentmentMoney {
        __typename
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "totalReceivedSet": {
        "presentmentMoney": {
          "__typename": "MoneyV2"
        }
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].totalReceivedSet.presentmentMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.totalReceivedSet.shopMoney"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    totalReceivedSet {
      shopMoney {
        __typename
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "totalReceivedSet": {
        "shopMoney": {
          "__typename": "MoneyV2"
        }
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].totalReceivedSet.shopMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.totalRefundedSet.*"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    totalRefundedSet {
      __typename
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "totalRefundedSet": {
        "__typename": "MoneyBag"
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].totalRefundedSet.presentmentMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.totalRefundedSet.presentmentMoney"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    totalRefundedSet {
      presentmentMoney {
        __typename
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "totalRefundedSet": {
        "presentmentMoney": {
          "__typename": "MoneyV2"
        }
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].totalRefundedSet.presentmentMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.totalRefundedSet.shopMoney"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    totalRefundedSet {
      shopMoney {
        __typename
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "totalRefundedSet": {
        "shopMoney": {
          "__typename": "MoneyV2"
        }
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].totalRefundedSet.shopMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.totalRefundedShippingSet.*"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    totalRefundedShippingSet {
      __typename
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "totalRefundedShippingSet": {
        "__typename": "MoneyBag"
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].totalRefundedShippingSet.presentmentMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.totalRefundedShippingSet.presentmentMoney"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    totalRefundedShippingSet {
      presentmentMoney {
        __typename
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "totalRefundedShippingSet": {
        "presentmentMoney": {
          "__typename": "MoneyV2"
        }
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].totalRefundedShippingSet.presentmentMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.totalRefundedShippingSet.shopMoney"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    totalRefundedShippingSet {
      shopMoney {
        __typename
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "totalRefundedShippingSet": {
        "shopMoney": {
          "__typename": "MoneyV2"
        }
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].totalRefundedShippingSet.shopMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.totalShippingPriceSet.*"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    totalShippingPriceSet {
      __typename
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "totalShippingPriceSet": {
        "__typename": "MoneyBag"
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].totalShippingPriceSet.presentmentMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.totalShippingPriceSet.presentmentMoney"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    totalShippingPriceSet {
      presentmentMoney {
        __typename
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "totalShippingPriceSet": {
        "presentmentMoney": {
          "__typename": "MoneyV2"
        }
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].totalShippingPriceSet.presentmentMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.totalShippingPriceSet.shopMoney"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    totalShippingPriceSet {
      shopMoney {
        __typename
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "totalShippingPriceSet": {
        "shopMoney": {
          "__typename": "MoneyV2"
        }
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].totalShippingPriceSet.shopMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.totalTaxSet.*"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    totalTaxSet {
      __typename
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "totalTaxSet": {
        "__typename": "MoneyBag"
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].totalTaxSet.presentmentMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.totalTaxSet.presentmentMoney"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    totalTaxSet {
      presentmentMoney {
        __typename
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "totalTaxSet": {
        "presentmentMoney": {
          "__typename": "MoneyV2"
        }
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].totalTaxSet.presentmentMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.totalTaxSet.shopMoney"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    totalTaxSet {
      shopMoney {
        __typename
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "totalTaxSet": {
        "shopMoney": {
          "__typename": "MoneyV2"
        }
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].totalTaxSet.shopMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.totalTipReceivedSet.*"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    totalTipReceivedSet {
      __typename
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "totalTipReceivedSet": {
        "__typename": "MoneyBag"
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].totalTipReceivedSet.presentmentMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.totalTipReceivedSet.presentmentMoney"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    totalTipReceivedSet {
      presentmentMoney {
        __typename
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "totalTipReceivedSet": {
        "presentmentMoney": {
          "__typename": "MoneyV2"
        }
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].totalTipReceivedSet.presentmentMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "order-event"

topic = "Order"
actions = ["update"]
triggers = ["order.totalTipReceivedSet.shopMoney"]

uri = "https://your-app.com/events"

query = """
query order_event_payload($orderId: ID!) {
  order(id: $orderId) {
    id
    name
    displayFinancialStatus
    displayFulfillmentStatus
    totalTipReceivedSet {
      shopMoney {
        __typename
      }
    }
  }
}
"""

Payload

{
  "topic": "Order",
  "action": "update",
  "handle": "order-event",
  "data": {
    "order": {
      "id": "gid://shopify/Order/5170247382690",
      "name": "Example order",
      "displayFinancialStatus": "PAID",
      "displayFulfillmentStatus": "FULFILLED",
      "totalTipReceivedSet": {
        "shopMoney": {
          "__typename": "MoneyV2"
        }
      }
    }
  },
  "fields_changed": {
    "added": [],
    "updated": [
      "order[id: 'gid://shopify/Order/5170247382690'].totalTipReceivedSet.shopMoney"
    ],
    "removed": []
  },
  "query_variables": {
    "orderId": "gid://shopify/Order/5170247382690"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-handle: order-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Order
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Was this page helpful?