---
title: Return
description: Subscribe to field-level changes on the Return GraphQL Admin API object.
api_version: 2026-10
source_url:
  html: 'https://shopify.dev/docs/api/events/latest/return'
  md: 'https://shopify.dev/docs/api/events/latest/return.md'
api_name: events
---

# Return

**Requires one of the `read_returns` or `read_marketplace_returns` access scopes.:**

Supported [actions](https://shopify.dev/docs/apps/build/events/subscribe#actions): `create`, `update`, `delete`

Subscribe to field-level changes on the [`Return`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Return) GraphQL Admin API object.

Each [topic](https://shopify.dev/docs/api/events/latest#configuration) corresponds to a commerce resource 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

```toml
[events]
api_version = "2026-10"


[[events.subscription]]
handle = "my_return_event"


topic = "Return"
actions = ["update"]
triggers = ["return.closedAt"]


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


query = """
query return_event_payload($returnId: ID!) {
  return(id: $returnId) {
    id
    name
    status
    closedAt
  }
}
"""
```

***

## Supported triggers

Field-level [triggers](https://shopify.dev/docs/api/events/latest#configuration) for `Return` subscriptions.

All triggers require one of the `read_returns` or `read_marketplace_returns` access scopes. 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 [`Return`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Return). They can query the full GraphQL Admin API.

### return​.\*[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Return)

Fires when events involve the [`Return`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Return) object, which represents the intent of a buyer to ship one or more items from an order back to a merchant or a third-party fulfillment location.

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.

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

**Variables:** `returnId`

### return​.closedAt[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Return#field-Return.fields.closedAt)

Fires when the [`closedAt`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Return#field-Return.fields.closedAt) field on the [`Return`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Return) 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`.

The `closedAt` field represents the date and time when the return was closed.

**Variables:** `returnId`

### return​.decline[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Return#field-Return.fields.decline)

Fires when the [`decline`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Return#field-Return.fields.decline) field on the [`Return`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Return) 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`.

Additional information about the declined return.

**Variables:** `returnId`

### return​.exchangeLineItems[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Return#field-Return.fields.exchangeLineItems)

Fires when the [`exchangeLineItems`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Return#field-Return.fields.exchangeLineItems) field on the [`Return`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Return) 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`.

The `exchangeLineItems` field represents the exchange line items attached to the return.

**Variables:** `exchangeLineItemsId`, `returnId`

### return​.requestApprovedAt[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Return#field-Return.fields.requestApprovedAt)

Fires when the [`requestApprovedAt`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Return#field-Return.fields.requestApprovedAt) field on the [`Return`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Return) 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`.

The `requestApprovedAt` field represents the date and time when the return was approved.

**Variables:** `returnId`

### return​.returnLineItems​.\*[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Return#field-Return.fields.returnLineItems)

Fires when the [`returnLineItems`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Return#field-Return.fields.returnLineItems) field on the [`Return`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Return) object changes.

`return.returnLineItems.*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `return.returnLineItems`, 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 `returnLineItems` field represents the return line items attached to the return.

**Variables:** `returnId`, `returnLineItemsId`

### return​.returnLineItems​.quantity[](https://shopify.dev/docs/api/admin-graphql/2026-10/interfaces/ReturnLineItemType#fields-quantity)

Fires when the [`quantity`](https://shopify.dev/docs/api/admin-graphql/2026-10/interfaces/ReturnLineItemType#fields-quantity) field on the [`ReturnLineItemType`](https://shopify.dev/docs/api/admin-graphql/2026-10/interfaces/ReturnLineItemType) interface 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`.

The `quantity` field represents the quantity being returned.

**Variables:** `returnId`, `returnLineItemsId`

### return​.returnLineItems​.refundableQuantity[](https://shopify.dev/docs/api/admin-graphql/2026-10/interfaces/ReturnLineItemType#fields-refundableQuantity)

Fires when the [`refundableQuantity`](https://shopify.dev/docs/api/admin-graphql/2026-10/interfaces/ReturnLineItemType#fields-refundableQuantity) field on the [`ReturnLineItemType`](https://shopify.dev/docs/api/admin-graphql/2026-10/interfaces/ReturnLineItemType) interface 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`.

The `refundableQuantity` field represents the quantity that can be refunded.

**Variables:** `returnId`

### return​.returnLineItems​.refundedQuantity[](https://shopify.dev/docs/api/admin-graphql/2026-10/interfaces/ReturnLineItemType#fields-refundedQuantity)

Fires when the [`refundedQuantity`](https://shopify.dev/docs/api/admin-graphql/2026-10/interfaces/ReturnLineItemType#fields-refundedQuantity) field on the [`ReturnLineItemType`](https://shopify.dev/docs/api/admin-graphql/2026-10/interfaces/ReturnLineItemType) interface 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`.

The `refundedQuantity` field represents the quantity that was refunded.

**Variables:** `returnId`

### return​.returnLineItems​.restockingFee​.\*[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/ReturnLineItem#field-ReturnLineItem.fields.restockingFee)

Fires when the [`restockingFee`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/ReturnLineItem#field-ReturnLineItem.fields.restockingFee) field on the [`ReturnLineItem`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/ReturnLineItem) object changes.

`return.returnLineItems.restockingFee.*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `return.returnLineItems.restockingFee`, 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 `restockingFee` field represents the restocking fee for the return line item.

**Variables:** `returnId`, `returnLineItemsId`

### return​.returnLineItems​.restockingFee​.amountSet​.\*[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/RestockingFee#field-RestockingFee.fields.amountSet)

Fires when the [`amountSet`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/RestockingFee#field-RestockingFee.fields.amountSet) field on the [`RestockingFee`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/RestockingFee) object changes.

`return.returnLineItems.restockingFee.amountSet.*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `return.returnLineItems.restockingFee.amountSet`, 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 `amountSet` field represents the amount of the restocking fee, in shop and presentment currencies.

**Variables:** `returnId`, `returnLineItemsId`

### return​.returnLineItems​.restockingFee​.amountSet​.presentmentMoney[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MoneyBag#field-MoneyBag.fields.presentmentMoney)

Fires when the [`presentmentMoney`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MoneyBag#field-MoneyBag.fields.presentmentMoney) field on the [`MoneyBag`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MoneyBag) 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`.

Amount in presentment currency.

**Variables:** `returnId`, `returnLineItemsId`

### return​.returnLineItems​.restockingFee​.amountSet​.shopMoney[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MoneyBag#field-MoneyBag.fields.shopMoney)

Fires when the [`shopMoney`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MoneyBag#field-MoneyBag.fields.shopMoney) field on the [`MoneyBag`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MoneyBag) 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`.

Amount in shop currency.

**Variables:** `returnId`, `returnLineItemsId`

### return​.returnLineItems​.restockingFee​.percentage[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/RestockingFee#field-RestockingFee.fields.percentage)

Fires when the [`percentage`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/RestockingFee#field-RestockingFee.fields.percentage) field on the [`RestockingFee`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/RestockingFee) 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`.

The `percentage` field represents the value of the fee as a percentage.

**Variables:** `returnId`, `returnLineItemsId`

### return​.returnLineItems​.unprocessedQuantity[](https://shopify.dev/docs/api/admin-graphql/2026-10/interfaces/ReturnLineItemType#fields-unprocessedQuantity)

Fires when the [`unprocessedQuantity`](https://shopify.dev/docs/api/admin-graphql/2026-10/interfaces/ReturnLineItemType#fields-unprocessedQuantity) field on the [`ReturnLineItemType`](https://shopify.dev/docs/api/admin-graphql/2026-10/interfaces/ReturnLineItemType) interface 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`.

The `unprocessedQuantity` field represents the quantity that has't been processed.

**Variables:** `returnId`

### return​.returnShippingFees​.\*[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Return#field-Return.fields.returnShippingFees)

Fires when the [`returnShippingFees`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Return#field-Return.fields.returnShippingFees) field on the [`Return`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Return) object changes.

`return.returnShippingFees.*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `return.returnShippingFees`, 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 `returnShippingFees` field represents the return shipping fees for the return.

**Variables:** `returnId`, `returnShippingFeesId`

### return​.returnShippingFees​.amountSet​.\*[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/ReturnShippingFee#field-ReturnShippingFee.fields.amountSet)

Fires when the [`amountSet`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/ReturnShippingFee#field-ReturnShippingFee.fields.amountSet) field on the [`ReturnShippingFee`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/ReturnShippingFee) object changes.

`return.returnShippingFees.amountSet.*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `return.returnShippingFees.amountSet`, 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 `amountSet` field represents the amount of the return shipping fee, in shop and presentment currencies.

**Variables:** `returnId`, `returnShippingFeesId`

### return​.returnShippingFees​.amountSet​.presentmentMoney[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MoneyBag#field-MoneyBag.fields.presentmentMoney)

Fires when the [`presentmentMoney`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MoneyBag#field-MoneyBag.fields.presentmentMoney) field on the [`MoneyBag`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MoneyBag) 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`.

Amount in presentment currency.

**Variables:** `returnId`, `returnShippingFeesId`

### return​.returnShippingFees​.amountSet​.shopMoney[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MoneyBag#field-MoneyBag.fields.shopMoney)

Fires when the [`shopMoney`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MoneyBag#field-MoneyBag.fields.shopMoney) field on the [`MoneyBag`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MoneyBag) 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`.

Amount in shop currency.

**Variables:** `returnId`, `returnShippingFeesId`

### return​.reverseFulfillmentOrders​.\*[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Return#field-Return.fields.reverseFulfillmentOrders)

Fires when the [`reverseFulfillmentOrders`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Return#field-Return.fields.reverseFulfillmentOrders) field on the [`Return`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Return) object changes.

`return.reverseFulfillmentOrders.*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `return.reverseFulfillmentOrders`, 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 `reverseFulfillmentOrders` field represents the list of reverse fulfillment orders for the return.

**Variables:** `returnId`, `reverseFulfillmentOrdersId`

### return​.reverseFulfillmentOrders​.lineItems[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/ReverseFulfillmentOrder#field-ReverseFulfillmentOrder.fields.lineItems)

Fires when the [`lineItems`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/ReverseFulfillmentOrder#field-ReverseFulfillmentOrder.fields.lineItems) field on the [`ReverseFulfillmentOrder`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/ReverseFulfillmentOrder) 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`.

The `lineItems` field represents the list of reverse fulfillment order line items for the reverse fulfillment order.

**Variables:** `lineItemsId`, `returnId`, `reverseFulfillmentOrdersId`

### return​.reverseFulfillmentOrders​.status[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/ReverseFulfillmentOrder#field-ReverseFulfillmentOrder.fields.status)

Fires when the [`status`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/ReverseFulfillmentOrder#field-ReverseFulfillmentOrder.fields.status) field on the [`ReverseFulfillmentOrder`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/ReverseFulfillmentOrder) 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`.

The `status` field represents the status of the reverse fulfillment order.

**Variables:** `returnId`, `reverseFulfillmentOrdersId`

### return​.status[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Return#field-Return.fields.status)

Fires when the [`status`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Return#field-Return.fields.status) field on the [`Return`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Return) 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`.

The `status` field represents the status of the return.

**Variables:** `returnId`

### Examples

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

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

  topic = "Return"
  actions = ["create","update","delete"]
  triggers = ["return.*"]

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

  query = """
  query return_details($returnId: ID!) {
    return(id: $returnId) {
      id
      name
      status
    }
  }
  """
  ```

  ##### Payload (added)

  ```json
  {
    "topic": "Return",
    "action": "create",
    "handle": "return-event",
    "data": {
      "return": {
        "id": "gid://shopify/Return/5632446657570",
        "name": "Example return",
        "status": "ACTIVE"
      }
    },
    "fields_changed": {
      "added": [
        "return[id: 'gid://shopify/Return/5632446657570']"
      ],
      "updated": [],
      "removed": []
    },
    "query_variables": {
      "returnId": "gid://shopify/Return/5632446657570"
    }
  }
  ```

  ##### Payload (updated)

  ```json
  {
    "topic": "Return",
    "action": "update",
    "handle": "return-event",
    "data": {
      "return": {
        "id": "gid://shopify/Return/5632446657570",
        "name": "Example return",
        "status": "ACTIVE"
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "return[id: 'gid://shopify/Return/5632446657570'].closedAt"
      ],
      "removed": []
    },
    "query_variables": {
      "returnId": "gid://shopify/Return/5632446657570"
    }
  }
  ```

  ##### Payload (removed)

  ```json
  {
    "topic": "Return",
    "action": "delete",
    "handle": "return-event",
    "data": {
      "return": null
    },
    "fields_changed": {
      "added": [],
      "updated": [],
      "removed": [
        "return[id: 'gid://shopify/Return/5632446657570']"
      ]
    },
    "query_variables": {
      "returnId": "gid://shopify/Return/5632446657570"
    }
  }
  ```

  ##### Headers

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

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

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

  topic = "Return"
  actions = ["update"]
  triggers = ["return.closedAt"]

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

  query = """
  query return_event_payload($returnId: ID!) {
    return(id: $returnId) {
      id
      name
      status
      closedAt
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Return",
    "action": "update",
    "handle": "return-event",
    "data": {
      "return": {
        "id": "gid://shopify/Return/5632446657570",
        "name": "Example return",
        "status": "ACTIVE",
        "closedAt": "…"
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "return[id: 'gid://shopify/Return/5632446657570'].closedAt"
      ],
      "removed": []
    },
    "query_variables": {
      "returnId": "gid://shopify/Return/5632446657570"
    }
  }
  ```

  ##### Headers

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

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

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

  topic = "Return"
  actions = ["update"]
  triggers = ["return.decline"]

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

  query = """
  query return_event_payload($returnId: ID!) {
    return(id: $returnId) {
      id
      name
      status
      decline {
        __typename
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Return",
    "action": "update",
    "handle": "return-event",
    "data": {
      "return": {
        "id": "gid://shopify/Return/5632446657570",
        "name": "Example return",
        "status": "ACTIVE",
        "decline": {
          "__typename": "ReturnDecline"
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "return[id: 'gid://shopify/Return/5632446657570'].decline"
      ],
      "removed": []
    },
    "query_variables": {
      "returnId": "gid://shopify/Return/5632446657570"
    }
  }
  ```

  ##### Headers

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

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

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

  topic = "Return"
  actions = ["update"]
  triggers = ["return.exchangeLineItems"]

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

  query = """
  query return_event_payload($returnId: ID!) {
    return(id: $returnId) {
      id
      name
      status
      exchangeLineItems(first: 10) {
        nodes {
          id
        }
      }
    }
  }
  """
  ```

  ##### Payload (added)

  ```json
  {
    "topic": "Return",
    "action": "update",
    "handle": "return-event",
    "data": {
      "return": {
        "id": "gid://shopify/Return/5632446657570",
        "name": "Example return",
        "status": "ACTIVE",
        "exchangeLineItems": {
          "nodes": [
            {
              "id": "gid://shopify/ExchangeLineItem/7291118221173"
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [
        "return[id: 'gid://shopify/Return/5632446657570'].exchangeLineItems[id: 'gid://shopify/ExchangeLineItem/7291118221173']"
      ],
      "updated": [],
      "removed": []
    },
    "query_variables": {
      "exchangeLineItemsId": "gid://shopify/ExchangeLineItem/7291118221173",
      "returnId": "gid://shopify/Return/5632446657570"
    }
  }
  ```

  ##### Payload (removed)

  ```json
  {
    "topic": "Return",
    "action": "update",
    "handle": "return-event",
    "data": {
      "return": {
        "id": "gid://shopify/Return/5632446657570",
        "name": "Example return",
        "status": "ACTIVE",
        "exchangeLineItems": {
          "nodes": [
            {
              "id": "gid://shopify/ExchangeLineItem/111"
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [],
      "removed": [
        "return[id: 'gid://shopify/Return/5632446657570'].exchangeLineItems[id: 'gid://shopify/ExchangeLineItem/7291118221173']"
      ]
    },
    "query_variables": {
      "exchangeLineItemsId": "gid://shopify/ExchangeLineItem/7291118221173",
      "returnId": "gid://shopify/Return/5632446657570"
    }
  }
  ```

  ##### Headers

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

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

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

  topic = "Return"
  actions = ["update"]
  triggers = ["return.requestApprovedAt"]

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

  query = """
  query return_event_payload($returnId: ID!) {
    return(id: $returnId) {
      id
      name
      status
      requestApprovedAt
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Return",
    "action": "update",
    "handle": "return-event",
    "data": {
      "return": {
        "id": "gid://shopify/Return/5632446657570",
        "name": "Example return",
        "status": "ACTIVE",
        "requestApprovedAt": "…"
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "return[id: 'gid://shopify/Return/5632446657570'].requestApprovedAt"
      ],
      "removed": []
    },
    "query_variables": {
      "returnId": "gid://shopify/Return/5632446657570"
    }
  }
  ```

  ##### Headers

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

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

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

  topic = "Return"
  actions = ["update"]
  triggers = ["return.returnLineItems.*"]

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

  query = """
  query return_event_payload($returnId: ID!) {
    return(id: $returnId) {
      id
      name
      status
      returnLineItems(first: 10) {
        nodes {
          id
        }
      }
    }
  }
  """
  ```

  ##### Payload (added)

  ```json
  {
    "topic": "Return",
    "action": "update",
    "handle": "return-event",
    "data": {
      "return": {
        "id": "gid://shopify/Return/5632446657570",
        "name": "Example return",
        "status": "ACTIVE",
        "returnLineItems": {
          "nodes": [
            {
              "id": "gid://shopify/ReturnLineItem/6818717966715"
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [
        "return[id: 'gid://shopify/Return/5632446657570'].returnLineItems[id: 'gid://shopify/ReturnLineItem/6818717966715']"
      ],
      "updated": [],
      "removed": []
    },
    "query_variables": {
      "returnId": "gid://shopify/Return/5632446657570",
      "returnLineItemsId": "gid://shopify/ReturnLineItem/6818717966715"
    }
  }
  ```

  ##### Payload (removed)

  ```json
  {
    "topic": "Return",
    "action": "update",
    "handle": "return-event",
    "data": {
      "return": {
        "id": "gid://shopify/Return/5632446657570",
        "name": "Example return",
        "status": "ACTIVE",
        "returnLineItems": {
          "nodes": [
            {
              "id": "gid://shopify/ReturnLineItemType/111"
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [],
      "removed": [
        "return[id: 'gid://shopify/Return/5632446657570'].returnLineItems[id: 'gid://shopify/ReturnLineItem/6818717966715']"
      ]
    },
    "query_variables": {
      "returnId": "gid://shopify/Return/5632446657570",
      "returnLineItemsId": "gid://shopify/ReturnLineItem/6818717966715"
    }
  }
  ```

  ##### Headers

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

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

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

  topic = "Return"
  actions = ["update"]
  triggers = ["return.returnLineItems.quantity"]

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

  query = """
  query return_event_payload($returnId: ID!) {
    return(id: $returnId) {
      id
      name
      status
      returnLineItems(first: 10) {
        nodes {
          quantity
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Return",
    "action": "update",
    "handle": "return-event",
    "data": {
      "return": {
        "id": "gid://shopify/Return/5632446657570",
        "name": "Example return",
        "status": "ACTIVE",
        "returnLineItems": {
          "nodes": [
            {
              "quantity": "…"
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "return[id: 'gid://shopify/Return/5632446657570'].returnLineItems[id: 'gid://shopify/ReturnLineItem/6818717966715'].quantity"
      ],
      "removed": []
    },
    "query_variables": {
      "returnId": "gid://shopify/Return/5632446657570",
      "returnLineItemsId": "gid://shopify/ReturnLineItem/6818717966715"
    }
  }
  ```

  ##### Headers

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

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

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

  topic = "Return"
  actions = ["update"]
  triggers = ["return.returnLineItems.refundableQuantity"]

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

  query = """
  query return_event_payload($returnId: ID!) {
    return(id: $returnId) {
      id
      name
      status
      returnLineItems(first: 10) {
        nodes {
          refundableQuantity
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Return",
    "action": "update",
    "handle": "return-event",
    "data": {
      "return": {
        "id": "gid://shopify/Return/5632446657570",
        "name": "Example return",
        "status": "ACTIVE",
        "returnLineItems": {
          "nodes": [
            {
              "refundableQuantity": "…"
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "return[id: 'gid://shopify/Return/5632446657570'].returnLineItems.refundableQuantity"
      ],
      "removed": []
    },
    "query_variables": {
      "returnId": "gid://shopify/Return/5632446657570"
    }
  }
  ```

  ##### Headers

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

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

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

  topic = "Return"
  actions = ["update"]
  triggers = ["return.returnLineItems.refundedQuantity"]

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

  query = """
  query return_event_payload($returnId: ID!) {
    return(id: $returnId) {
      id
      name
      status
      returnLineItems(first: 10) {
        nodes {
          refundedQuantity
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Return",
    "action": "update",
    "handle": "return-event",
    "data": {
      "return": {
        "id": "gid://shopify/Return/5632446657570",
        "name": "Example return",
        "status": "ACTIVE",
        "returnLineItems": {
          "nodes": [
            {
              "refundedQuantity": "…"
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "return[id: 'gid://shopify/Return/5632446657570'].returnLineItems.refundedQuantity"
      ],
      "removed": []
    },
    "query_variables": {
      "returnId": "gid://shopify/Return/5632446657570"
    }
  }
  ```

  ##### Headers

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

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

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

  topic = "Return"
  actions = ["update"]
  triggers = ["return.returnLineItems.restockingFee.*"]

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

  query = """
  query return_event_payload($returnId: ID!) {
    return(id: $returnId) {
      id
      name
      status
      returnLineItems(first: 10) {
        nodes {
          ... on ReturnLineItem {
            restockingFee {
              id
            }
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Return",
    "action": "update",
    "handle": "return-event",
    "data": {
      "return": {
        "id": "gid://shopify/Return/5632446657570",
        "name": "Example return",
        "status": "ACTIVE",
        "returnLineItems": {
          "nodes": [
            {
              "restockingFee": {
                "id": "gid://shopify/RestockingFee/111"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "return[id: 'gid://shopify/Return/5632446657570'].returnLineItems[id: 'gid://shopify/ReturnLineItem/6818717966715'].restockingFee"
      ],
      "removed": []
    },
    "query_variables": {
      "returnId": "gid://shopify/Return/5632446657570",
      "returnLineItemsId": "gid://shopify/ReturnLineItem/6818717966715"
    }
  }
  ```

  ##### Headers

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

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

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

  topic = "Return"
  actions = ["update"]
  triggers = ["return.returnLineItems.restockingFee.amountSet.*"]

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

  query = """
  query return_event_payload($returnId: ID!) {
    return(id: $returnId) {
      id
      name
      status
      returnLineItems(first: 10) {
        nodes {
          ... on ReturnLineItem {
            restockingFee {
              amountSet {
                __typename
              }
            }
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Return",
    "action": "update",
    "handle": "return-event",
    "data": {
      "return": {
        "id": "gid://shopify/Return/5632446657570",
        "name": "Example return",
        "status": "ACTIVE",
        "returnLineItems": {
          "nodes": [
            {
              "restockingFee": {
                "amountSet": {
                  "__typename": "MoneyBag"
                }
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "return[id: 'gid://shopify/Return/5632446657570'].returnLineItems[id: 'gid://shopify/ReturnLineItem/6818717966715'].restockingFee.amountSet.presentmentMoney"
      ],
      "removed": []
    },
    "query_variables": {
      "returnId": "gid://shopify/Return/5632446657570",
      "returnLineItemsId": "gid://shopify/ReturnLineItem/6818717966715"
    }
  }
  ```

  ##### Headers

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

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

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

  topic = "Return"
  actions = ["update"]
  triggers = ["return.returnLineItems.restockingFee.amountSet.presentmentMoney"]

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

  query = """
  query return_event_payload($returnId: ID!) {
    return(id: $returnId) {
      id
      name
      status
      returnLineItems(first: 10) {
        nodes {
          ... on ReturnLineItem {
            restockingFee {
              amountSet {
                presentmentMoney {
                  __typename
                }
              }
            }
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Return",
    "action": "update",
    "handle": "return-event",
    "data": {
      "return": {
        "id": "gid://shopify/Return/5632446657570",
        "name": "Example return",
        "status": "ACTIVE",
        "returnLineItems": {
          "nodes": [
            {
              "restockingFee": {
                "amountSet": {
                  "presentmentMoney": {
                    "__typename": "MoneyV2"
                  }
                }
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "return[id: 'gid://shopify/Return/5632446657570'].returnLineItems[id: 'gid://shopify/ReturnLineItem/6818717966715'].restockingFee.amountSet.presentmentMoney"
      ],
      "removed": []
    },
    "query_variables": {
      "returnId": "gid://shopify/Return/5632446657570",
      "returnLineItemsId": "gid://shopify/ReturnLineItem/6818717966715"
    }
  }
  ```

  ##### Headers

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

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

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

  topic = "Return"
  actions = ["update"]
  triggers = ["return.returnLineItems.restockingFee.amountSet.shopMoney"]

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

  query = """
  query return_event_payload($returnId: ID!) {
    return(id: $returnId) {
      id
      name
      status
      returnLineItems(first: 10) {
        nodes {
          ... on ReturnLineItem {
            restockingFee {
              amountSet {
                shopMoney {
                  __typename
                }
              }
            }
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Return",
    "action": "update",
    "handle": "return-event",
    "data": {
      "return": {
        "id": "gid://shopify/Return/5632446657570",
        "name": "Example return",
        "status": "ACTIVE",
        "returnLineItems": {
          "nodes": [
            {
              "restockingFee": {
                "amountSet": {
                  "shopMoney": {
                    "__typename": "MoneyV2"
                  }
                }
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "return[id: 'gid://shopify/Return/5632446657570'].returnLineItems[id: 'gid://shopify/ReturnLineItem/6818717966715'].restockingFee.amountSet.shopMoney"
      ],
      "removed": []
    },
    "query_variables": {
      "returnId": "gid://shopify/Return/5632446657570",
      "returnLineItemsId": "gid://shopify/ReturnLineItem/6818717966715"
    }
  }
  ```

  ##### Headers

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

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

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

  topic = "Return"
  actions = ["update"]
  triggers = ["return.returnLineItems.restockingFee.percentage"]

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

  query = """
  query return_event_payload($returnId: ID!) {
    return(id: $returnId) {
      id
      name
      status
      returnLineItems(first: 10) {
        nodes {
          ... on ReturnLineItem {
            restockingFee {
              percentage
            }
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Return",
    "action": "update",
    "handle": "return-event",
    "data": {
      "return": {
        "id": "gid://shopify/Return/5632446657570",
        "name": "Example return",
        "status": "ACTIVE",
        "returnLineItems": {
          "nodes": [
            {
              "restockingFee": {
                "percentage": "…"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "return[id: 'gid://shopify/Return/5632446657570'].returnLineItems[id: 'gid://shopify/ReturnLineItem/6818717966715'].restockingFee.percentage"
      ],
      "removed": []
    },
    "query_variables": {
      "returnId": "gid://shopify/Return/5632446657570",
      "returnLineItemsId": "gid://shopify/ReturnLineItem/6818717966715"
    }
  }
  ```

  ##### Headers

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

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

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

  topic = "Return"
  actions = ["update"]
  triggers = ["return.returnLineItems.unprocessedQuantity"]

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

  query = """
  query return_event_payload($returnId: ID!) {
    return(id: $returnId) {
      id
      name
      status
      returnLineItems(first: 10) {
        nodes {
          unprocessedQuantity
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Return",
    "action": "update",
    "handle": "return-event",
    "data": {
      "return": {
        "id": "gid://shopify/Return/5632446657570",
        "name": "Example return",
        "status": "ACTIVE",
        "returnLineItems": {
          "nodes": [
            {
              "unprocessedQuantity": "…"
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "return[id: 'gid://shopify/Return/5632446657570'].returnLineItems.unprocessedQuantity"
      ],
      "removed": []
    },
    "query_variables": {
      "returnId": "gid://shopify/Return/5632446657570"
    }
  }
  ```

  ##### Headers

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

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

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

  topic = "Return"
  actions = ["update"]
  triggers = ["return.returnShippingFees.*"]

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

  query = """
  query return_event_payload($returnId: ID!) {
    return(id: $returnId) {
      id
      name
      status
      returnShippingFees {
        id
      }
    }
  }
  """
  ```

  ##### Payload (added)

  ```json
  {
    "topic": "Return",
    "action": "update",
    "handle": "return-event",
    "data": {
      "return": {
        "id": "gid://shopify/Return/5632446657570",
        "name": "Example return",
        "status": "ACTIVE",
        "returnShippingFees": [
          {
            "id": "gid://shopify/Fee/9594803981870"
          }
        ]
      }
    },
    "fields_changed": {
      "added": [
        "return[id: 'gid://shopify/Return/5632446657570'].returnShippingFees[id: 'gid://shopify/Fee/9594803981870']"
      ],
      "updated": [],
      "removed": []
    },
    "query_variables": {
      "returnId": "gid://shopify/Return/5632446657570",
      "returnShippingFeesId": "gid://shopify/Fee/9594803981870"
    }
  }
  ```

  ##### Payload (removed)

  ```json
  {
    "topic": "Return",
    "action": "update",
    "handle": "return-event",
    "data": {
      "return": {
        "id": "gid://shopify/Return/5632446657570",
        "name": "Example return",
        "status": "ACTIVE",
        "returnShippingFees": [
          {
            "id": "gid://shopify/ReturnShippingFee/111"
          }
        ]
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [],
      "removed": [
        "return[id: 'gid://shopify/Return/5632446657570'].returnShippingFees[id: 'gid://shopify/Fee/9594803981870']"
      ]
    },
    "query_variables": {
      "returnId": "gid://shopify/Return/5632446657570",
      "returnShippingFeesId": "gid://shopify/Fee/9594803981870"
    }
  }
  ```

  ##### Headers

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

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

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

  topic = "Return"
  actions = ["update"]
  triggers = ["return.returnShippingFees.amountSet.*"]

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

  query = """
  query return_event_payload($returnId: ID!) {
    return(id: $returnId) {
      id
      name
      status
      returnShippingFees {
        amountSet {
          __typename
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Return",
    "action": "update",
    "handle": "return-event",
    "data": {
      "return": {
        "id": "gid://shopify/Return/5632446657570",
        "name": "Example return",
        "status": "ACTIVE",
        "returnShippingFees": [
          {
            "amountSet": {
              "__typename": "MoneyBag"
            }
          }
        ]
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "return[id: 'gid://shopify/Return/5632446657570'].returnShippingFees[id: 'gid://shopify/Fee/9594803981870'].amountSet.presentmentMoney"
      ],
      "removed": []
    },
    "query_variables": {
      "returnId": "gid://shopify/Return/5632446657570",
      "returnShippingFeesId": "gid://shopify/Fee/9594803981870"
    }
  }
  ```

  ##### Headers

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

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

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

  topic = "Return"
  actions = ["update"]
  triggers = ["return.returnShippingFees.amountSet.presentmentMoney"]

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

  query = """
  query return_event_payload($returnId: ID!) {
    return(id: $returnId) {
      id
      name
      status
      returnShippingFees {
        amountSet {
          presentmentMoney {
            __typename
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Return",
    "action": "update",
    "handle": "return-event",
    "data": {
      "return": {
        "id": "gid://shopify/Return/5632446657570",
        "name": "Example return",
        "status": "ACTIVE",
        "returnShippingFees": [
          {
            "amountSet": {
              "presentmentMoney": {
                "__typename": "MoneyV2"
              }
            }
          }
        ]
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "return[id: 'gid://shopify/Return/5632446657570'].returnShippingFees[id: 'gid://shopify/Fee/9594803981870'].amountSet.presentmentMoney"
      ],
      "removed": []
    },
    "query_variables": {
      "returnId": "gid://shopify/Return/5632446657570",
      "returnShippingFeesId": "gid://shopify/Fee/9594803981870"
    }
  }
  ```

  ##### Headers

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

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

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

  topic = "Return"
  actions = ["update"]
  triggers = ["return.returnShippingFees.amountSet.shopMoney"]

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

  query = """
  query return_event_payload($returnId: ID!) {
    return(id: $returnId) {
      id
      name
      status
      returnShippingFees {
        amountSet {
          shopMoney {
            __typename
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Return",
    "action": "update",
    "handle": "return-event",
    "data": {
      "return": {
        "id": "gid://shopify/Return/5632446657570",
        "name": "Example return",
        "status": "ACTIVE",
        "returnShippingFees": [
          {
            "amountSet": {
              "shopMoney": {
                "__typename": "MoneyV2"
              }
            }
          }
        ]
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "return[id: 'gid://shopify/Return/5632446657570'].returnShippingFees[id: 'gid://shopify/Fee/9594803981870'].amountSet.shopMoney"
      ],
      "removed": []
    },
    "query_variables": {
      "returnId": "gid://shopify/Return/5632446657570",
      "returnShippingFeesId": "gid://shopify/Fee/9594803981870"
    }
  }
  ```

  ##### Headers

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

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

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

  topic = "Return"
  actions = ["update"]
  triggers = ["return.reverseFulfillmentOrders.*"]

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

  query = """
  query return_event_payload($returnId: ID!) {
    return(id: $returnId) {
      id
      name
      status
      reverseFulfillmentOrders(first: 10) {
        nodes {
          id
        }
      }
    }
  }
  """
  ```

  ##### Payload (added)

  ```json
  {
    "topic": "Return",
    "action": "update",
    "handle": "return-event",
    "data": {
      "return": {
        "id": "gid://shopify/Return/5632446657570",
        "name": "Example return",
        "status": "ACTIVE",
        "reverseFulfillmentOrders": {
          "nodes": [
            {
              "id": "gid://shopify/ReverseFulfillmentOrder/1710821242743"
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [
        "return[id: 'gid://shopify/Return/5632446657570'].reverseFulfillmentOrders[id: 'gid://shopify/ReverseFulfillmentOrder/1710821242743']"
      ],
      "updated": [],
      "removed": []
    },
    "query_variables": {
      "returnId": "gid://shopify/Return/5632446657570",
      "reverseFulfillmentOrdersId": "gid://shopify/ReverseFulfillmentOrder/1710821242743"
    }
  }
  ```

  ##### Headers

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

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

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

  topic = "Return"
  actions = ["update"]
  triggers = ["return.reverseFulfillmentOrders.lineItems"]

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

  query = """
  query return_event_payload($returnId: ID!) {
    return(id: $returnId) {
      id
      name
      status
      reverseFulfillmentOrders(first: 10) {
        nodes {
          lineItems(first: 10) {
            nodes {
              id
            }
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload (removed)

  ```json
  {
    "topic": "Return",
    "action": "update",
    "handle": "return-event",
    "data": {
      "return": {
        "id": "gid://shopify/Return/5632446657570",
        "name": "Example return",
        "status": "ACTIVE",
        "reverseFulfillmentOrders": {
          "nodes": [
            {
              "lineItems": {
                "nodes": [
                  {
                    "id": "gid://shopify/ReverseFulfillmentOrderLineItem/111"
                  }
                ]
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [],
      "removed": [
        "return[id: 'gid://shopify/Return/5632446657570'].reverseFulfillmentOrders[id: 'gid://shopify/ReverseFulfillmentOrder/1710821242743'].lineItems[id: 'gid://shopify/ReverseFulfillmentOrderLineItem/2472588472838']"
      ]
    },
    "query_variables": {
      "lineItemsId": "gid://shopify/ReverseFulfillmentOrderLineItem/2472588472838",
      "returnId": "gid://shopify/Return/5632446657570",
      "reverseFulfillmentOrdersId": "gid://shopify/ReverseFulfillmentOrder/1710821242743"
    }
  }
  ```

  ##### Headers

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

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

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

  topic = "Return"
  actions = ["update"]
  triggers = ["return.reverseFulfillmentOrders.status"]

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

  query = """
  query return_event_payload($returnId: ID!) {
    return(id: $returnId) {
      id
      name
      status
      reverseFulfillmentOrders(first: 10) {
        nodes {
          status
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Return",
    "action": "update",
    "handle": "return-event",
    "data": {
      "return": {
        "id": "gid://shopify/Return/5632446657570",
        "name": "Example return",
        "status": "ACTIVE",
        "reverseFulfillmentOrders": {
          "nodes": [
            {
              "status": "…"
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "return[id: 'gid://shopify/Return/5632446657570'].reverseFulfillmentOrders[id: 'gid://shopify/ReverseFulfillmentOrder/1710821242743'].status"
      ],
      "removed": []
    },
    "query_variables": {
      "returnId": "gid://shopify/Return/5632446657570",
      "reverseFulfillmentOrdersId": "gid://shopify/ReverseFulfillmentOrder/1710821242743"
    }
  }
  ```

  ##### Headers

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

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

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

  topic = "Return"
  actions = ["update"]
  triggers = ["return.status"]

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

  query = """
  query return_event_payload($returnId: ID!) {
    return(id: $returnId) {
      id
      name
      status
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Return",
    "action": "update",
    "handle": "return-event",
    "data": {
      "return": {
        "id": "gid://shopify/Return/5632446657570",
        "name": "Example return",
        "status": "ACTIVE"
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "return[id: 'gid://shopify/Return/5632446657570'].status"
      ],
      "removed": []
    },
    "query_variables": {
      "returnId": "gid://shopify/Return/5632446657570"
    }
  }
  ```

  ##### Headers

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

***