---
title: InventoryItem
description: >-
  Subscribe to field-level changes on the InventoryItem GraphQL Admin API
  object.
api_version: unstable
source_url:
  html: 'https://shopify.dev/docs/api/events/latest/inventory-item'
  md: 'https://shopify.dev/docs/api/events/latest/inventory-item.md'
api_name: events
---

# Inventory​Item

**Requires \`read\_inventory\` access scope.:**

Subscribe to field-level changes on the [`InventoryItem`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryItem) GraphQL Admin API object. You can subscribe to create, delete, and update events, as well as changes to specific fields.

Each [topic](https://shopify.dev/docs/api/events/latest#configuration) corresponds to a commerce resource (for example, an inventory item) 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 = "unstable"


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


topic = "InventoryItem"
actions = ["update"]
triggers = [
    "inventoryItem.sku",
    "inventoryItem.tracked"
]


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


query = """
query inventory_item_details($inventoryItemId: ID!) {
  inventoryItem(id: $inventoryItemId) {
    id
    sku
    tracked
    requiresShipping
    measurement {
      weight {
        unit
        value
      }
    }
  }
  shop {
    id
  }
}
"""
```

***

## Supported triggers

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

All triggers require the [`read_inventory`](https://shopify.dev/docs/api/usage/access-scopes) access scope, 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 [`InventoryItem`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryItem). They can query the full GraphQL Admin API.

### inventoryItem

Fires when events involve the [`InventoryItem`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryItem) object.

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.

Collect details about changes to the object by subscribing to the trigger along with the `"update"` action, though it's recommended that you narrow your subscription to one of the other triggers below.

**Variables:** `inventoryItemId`

### inventoryItem​.countryCodeOfOrigin

Fires when the [`countryCodeOfOrigin`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryItem#field-InventoryItem.fields.countryCodeOfOrigin) field on the [`InventoryItem`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryItem) 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 `countryCodeOfOrigin` field represents the ISO 3166-1 alpha-2 country code of where the item originated from.

**Variables:** `inventoryItemId`

### inventoryItem​.harmonizedSystemCode

Fires when the [`harmonizedSystemCode`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryItem#field-InventoryItem.fields.harmonizedSystemCode) field on the [`InventoryItem`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryItem) 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 `harmonizedSystemCode` field represents the harmonized system code of the item.

**Variables:** `inventoryItemId`

### inventoryItem​.inventoryLevel

Fires when the [`inventoryLevel`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryItem#field-InventoryItem.fields.inventoryLevel) field on the [`InventoryItem`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryItem) 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 `inventoryLevel` field represents the inventory item's quantities at the specified location.

**Variables:** `inventoryItemId`, `inventoryLevelId`

### inventoryItem​.inventoryLevel​.isActive

Fires when the [`isActive`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryLevel#field-InventoryLevel.fields.isActive) field on the [`InventoryLevel`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryLevel) 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 `isActive` field indicates whether the inventory level is active.

**Variables:** `inventoryItemId`, `inventoryLevelId`

### inventoryItem​.inventoryLevel​.quantities

Fires when the [`quantities`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryLevel#field-InventoryLevel.fields.quantities) field on the [`InventoryLevel`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryLevel) 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 `quantities` field represents the quantity of an inventory item at a specific location, for a quantity name.

**Variables:** `inventoryItemId`, `inventoryLevelId`, `quantitiesName`

### inventoryItem​.inventoryLevel​.quantities​.quantity

Fires when the [`quantity`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryQuantity#field-InventoryQuantity.fields.quantity) field on the [`InventoryQuantity`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryQuantity) 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 `quantity` field represents the quantity of an inventory item at a specific location, for a quantity name.

**Variables:** `inventoryItemId`, `inventoryLevelId`, `quantitiesName`

### inventoryItem​.measurement

Fires when the [`measurement`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryItem#field-InventoryItem.fields.measurement) field on the [`InventoryItem`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryItem) 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 `measurement` field represents the packaging dimensions of the inventory item.

**Variables:** `inventoryItemId`

### inventoryItem​.measurement​.weight

Fires when the [`weight`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryItemMeasurement#field-InventoryItemMeasurement.fields.weight) field on the [`InventoryItemMeasurement`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryItemMeasurement) 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 `weight` field represents the weight of the inventory item.

**Variables:** `inventoryItemId`

### inventoryItem​.measurement​.weight​.unit

Fires when the [`unit`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Weight#field-Weight.fields.unit) field on the [`Weight`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Weight) 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 `unit` field represents the unit of measurement for `value`.

**Variables:** `inventoryItemId`

### inventoryItem​.measurement​.weight​.value

Fires when the [`value`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Weight#field-Weight.fields.value) field on the [`Weight`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Weight) 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 `value` field represents the weight value using the unit system specified with `unit`.

**Variables:** `inventoryItemId`

### inventoryItem​.provinceCodeOfOrigin

Fires when the [`provinceCodeOfOrigin`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryItem#field-InventoryItem.fields.provinceCodeOfOrigin) field on the [`InventoryItem`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryItem) 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 `provinceCodeOfOrigin` field represents the ISO 3166-2 alpha-2 province code of where the item originated from.

**Variables:** `inventoryItemId`

### inventoryItem​.requiresShipping

Fires when the [`requiresShipping`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryItem#field-InventoryItem.fields.requiresShipping) field on the [`InventoryItem`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryItem) 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 `requiresShipping` field indicates whether the inventory item requires shipping.

**Variables:** `inventoryItemId`

### inventoryItem​.sku

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

Inventory item SKU.

**Variables:** `inventoryItemId`

### inventoryItem​.tracked

Fires when the [`tracked`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryItem#field-InventoryItem.fields.tracked) field on the [`InventoryItem`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryItem) 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 `tracked` field indicates whether inventory levels are tracked for the item.

**Variables:** `inventoryItemId`

### inventoryItem​.trackedEditable

Fires when the [`trackedEditable`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryItem#field-InventoryItem.fields.trackedEditable) field on the [`InventoryItem`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryItem) 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 `trackedEditable` field indicates whether the value of the `tracked` field for the inventory item can be changed.

**Variables:** `inventoryItemId`

### inventoryItem​.unitCost

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

Unit cost associated with the inventory item.

**Variables:** `inventoryItemId`

### inventoryItem​.variants

Fires when the [`variants`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryItem#field-InventoryItem.fields.variants) field on the [`InventoryItem`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryItem) 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 `variants` field represents a paginated list of the variants that reference this inventory item.

**Variables:** `inventoryItemId`, `variantsId`

### Examples

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

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

  topic = "InventoryItem"
  actions = ["create"]
  triggers = ["inventoryItem"]

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

  query = """
  query inventoryItem_details($inventoryItemId: ID!) {
    inventoryItem(id: $inventoryItemId) {
      id
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "InventoryItem",
    "action": "create",
    "handle": "inventoryItem-event",
    "data": {
      "inventoryItem": {
        "id": "gid://shopify/InventoryItem/123"
      }
    },
    "fields_changed": [
      "inventoryItem[id: 'gid://shopify/InventoryItem/123']"
    ],
    "query_variables": {
      "inventoryItemId": "gid://shopify/InventoryItem/123"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: create
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: inventoryItem-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/InventoryItem/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: InventoryItem
  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 = "unstable"

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

  topic = "InventoryItem"
  actions = ["update"]
  triggers = ["inventoryItem.countryCodeOfOrigin"]

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

  query = """
  query inventoryItem_event_payload($inventoryItemId: ID!) {
    inventoryItem(id: $inventoryItemId) {
      id
      countryCodeOfOrigin
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "InventoryItem",
    "action": "update",
    "handle": "inventoryItem-event",
    "data": {
      "inventoryItem": {
        "id": "gid://shopify/InventoryItem/123",
        "countryCodeOfOrigin": "…"
      }
    },
    "fields_changed": [
      "inventoryItem[id: 'gid://shopify/InventoryItem/123'].countryCodeOfOrigin"
    ],
    "query_variables": {
      "inventoryItemId": "gid://shopify/InventoryItem/123"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: inventoryItem-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/InventoryItem/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: InventoryItem
  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 = "unstable"

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

  topic = "InventoryItem"
  actions = ["update"]
  triggers = ["inventoryItem.harmonizedSystemCode"]

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

  query = """
  query inventoryItem_event_payload($inventoryItemId: ID!) {
    inventoryItem(id: $inventoryItemId) {
      id
      harmonizedSystemCode
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "InventoryItem",
    "action": "update",
    "handle": "inventoryItem-event",
    "data": {
      "inventoryItem": {
        "id": "gid://shopify/InventoryItem/123",
        "harmonizedSystemCode": "…"
      }
    },
    "fields_changed": [
      "inventoryItem[id: 'gid://shopify/InventoryItem/123'].harmonizedSystemCode"
    ],
    "query_variables": {
      "inventoryItemId": "gid://shopify/InventoryItem/123"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: inventoryItem-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/InventoryItem/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: InventoryItem
  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 = "unstable"

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

  topic = "InventoryItem"
  actions = ["update"]
  triggers = ["inventoryItem.inventoryLevel"]

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

  query = """
  query inventoryItem_event_payload($inventoryItemId: ID!, $inventoryLevelId: ID!) {
    inventoryItem(id: $inventoryItemId) {
      id
    }
    inventoryLevel: node(id: $inventoryLevelId) {
      ... on InventoryLevel {
        id
        isActive
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "InventoryItem",
    "action": "update",
    "handle": "inventoryItem-event",
    "data": {
      "inventoryItem": {
        "id": "gid://shopify/InventoryItem/123"
      },
      "inventoryLevel": {
        "id": "gid://shopify/InventoryLevel/123",
        "isActive": true
      }
    },
    "fields_changed": [
      "inventoryItem[id: 'gid://shopify/InventoryItem/123'].inventoryLevel"
    ],
    "query_variables": {
      "inventoryItemId": "gid://shopify/InventoryItem/123",
      "inventoryLevelId": "gid://shopify/InventoryLevel/123"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: inventoryItem-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/InventoryItem/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: InventoryItem
  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 = "unstable"

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

  topic = "InventoryItem"
  actions = ["update"]
  triggers = ["inventoryItem.inventoryLevel.isActive"]

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

  query = """
  query inventoryItem_event_payload($inventoryItemId: ID!, $inventoryLevelId: ID!) {
    inventoryItem(id: $inventoryItemId) {
      id
    }
    inventoryLevel: node(id: $inventoryLevelId) {
      ... on InventoryLevel {
        isActive
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "InventoryItem",
    "action": "update",
    "handle": "inventoryItem-event",
    "data": {
      "inventoryItem": {
        "id": "gid://shopify/InventoryItem/123"
      },
      "inventoryLevel": {
        "isActive": true
      }
    },
    "fields_changed": [
      "inventoryItem[id: 'gid://shopify/InventoryItem/123'].inventoryLevel.isActive"
    ],
    "query_variables": {
      "inventoryItemId": "gid://shopify/InventoryItem/123",
      "inventoryLevelId": "gid://shopify/InventoryLevel/123"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: inventoryItem-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/InventoryItem/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: InventoryItem
  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 = "unstable"

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

  topic = "InventoryItem"
  actions = ["update"]
  triggers = ["inventoryItem.inventoryLevel.quantities"]

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

  query = """
  query inventoryItem_event_payload($inventoryItemId: ID!, $inventoryLevelId: ID!, $quantitiesName: String!) {
    inventoryItem(id: $inventoryItemId) {
      id
    }
    inventoryLevel: node(id: $inventoryLevelId) {
      ... on InventoryLevel {
        quantities(names: [$quantitiesName]) {
          name
          quantity
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "InventoryItem",
    "action": "update",
    "handle": "inventoryItem-event",
    "data": {
      "inventoryItem": {
        "id": "gid://shopify/InventoryItem/123"
      },
      "inventoryLevel": {
        "quantities": [
          {
            "name": "available",
            "quantity": 5
          }
        ]
      }
    },
    "fields_changed": [
      "inventoryItem[id: 'gid://shopify/InventoryItem/123'].inventoryLevel.quantities"
    ],
    "query_variables": {
      "inventoryItemId": "gid://shopify/InventoryItem/123",
      "inventoryLevelId": "gid://shopify/InventoryLevel/123",
      "quantitiesName": "available"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: inventoryItem-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/InventoryItem/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: InventoryItem
  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 = "unstable"

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

  topic = "InventoryItem"
  actions = ["update"]
  triggers = ["inventoryItem.inventoryLevel.quantities.quantity"]

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

  query = """
  query inventoryItem_event_payload($inventoryItemId: ID!, $inventoryLevelId: ID!, $quantitiesName: String!) {
    inventoryItem(id: $inventoryItemId) {
      id
    }
    inventoryLevel: node(id: $inventoryLevelId) {
      ... on InventoryLevel {
        quantities(names: [$quantitiesName]) {
          name
          quantity
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "InventoryItem",
    "action": "update",
    "handle": "inventoryItem-event",
    "data": {
      "inventoryItem": {
        "id": "gid://shopify/InventoryItem/123"
      },
      "inventoryLevel": {
        "quantities": [
          {
            "name": "available",
            "quantity": 5
          }
        ]
      }
    },
    "fields_changed": [
      "inventoryItem[id: 'gid://shopify/InventoryItem/123'].inventoryLevel.quantities.quantity"
    ],
    "query_variables": {
      "inventoryItemId": "gid://shopify/InventoryItem/123",
      "inventoryLevelId": "gid://shopify/InventoryLevel/123",
      "quantitiesName": "available"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: inventoryItem-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/InventoryItem/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: InventoryItem
  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 = "unstable"

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

  topic = "InventoryItem"
  actions = ["update"]
  triggers = ["inventoryItem.measurement"]

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

  query = """
  query inventoryItem_event_payload($inventoryItemId: ID!) {
    inventoryItem(id: $inventoryItemId) {
      id
      measurement {
        id
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "InventoryItem",
    "action": "update",
    "handle": "inventoryItem-event",
    "data": {
      "inventoryItem": {
        "id": "gid://shopify/InventoryItem/123",
        "measurement": {
          "id": "gid://shopify/InventoryItemMeasurement/111"
        }
      }
    },
    "fields_changed": [
      "inventoryItem[id: 'gid://shopify/InventoryItem/123'].measurement"
    ],
    "query_variables": {
      "inventoryItemId": "gid://shopify/InventoryItem/123"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: inventoryItem-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/InventoryItem/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: InventoryItem
  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 = "unstable"

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

  topic = "InventoryItem"
  actions = ["update"]
  triggers = ["inventoryItem.measurement.weight"]

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

  query = """
  query inventoryItem_event_payload($inventoryItemId: ID!) {
    inventoryItem(id: $inventoryItemId) {
      id
      measurement {
        weight {
          __typename
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "InventoryItem",
    "action": "update",
    "handle": "inventoryItem-event",
    "data": {
      "inventoryItem": {
        "id": "gid://shopify/InventoryItem/123",
        "measurement": {
          "weight": {
            "__typename": "Weight"
          }
        }
      }
    },
    "fields_changed": [
      "inventoryItem[id: 'gid://shopify/InventoryItem/123'].measurement.weight"
    ],
    "query_variables": {
      "inventoryItemId": "gid://shopify/InventoryItem/123"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: inventoryItem-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/InventoryItem/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: InventoryItem
  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 = "unstable"

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

  topic = "InventoryItem"
  actions = ["update"]
  triggers = ["inventoryItem.measurement.weight.unit"]

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

  query = """
  query inventoryItem_event_payload($inventoryItemId: ID!) {
    inventoryItem(id: $inventoryItemId) {
      id
      measurement {
        weight {
          unit
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "InventoryItem",
    "action": "update",
    "handle": "inventoryItem-event",
    "data": {
      "inventoryItem": {
        "id": "gid://shopify/InventoryItem/123",
        "measurement": {
          "weight": {
            "unit": "…"
          }
        }
      }
    },
    "fields_changed": [
      "inventoryItem[id: 'gid://shopify/InventoryItem/123'].measurement.weight.unit"
    ],
    "query_variables": {
      "inventoryItemId": "gid://shopify/InventoryItem/123"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: inventoryItem-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/InventoryItem/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: InventoryItem
  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 = "unstable"

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

  topic = "InventoryItem"
  actions = ["update"]
  triggers = ["inventoryItem.measurement.weight.value"]

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

  query = """
  query inventoryItem_event_payload($inventoryItemId: ID!) {
    inventoryItem(id: $inventoryItemId) {
      id
      measurement {
        weight {
          value
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "InventoryItem",
    "action": "update",
    "handle": "inventoryItem-event",
    "data": {
      "inventoryItem": {
        "id": "gid://shopify/InventoryItem/123",
        "measurement": {
          "weight": {
            "value": "…"
          }
        }
      }
    },
    "fields_changed": [
      "inventoryItem[id: 'gid://shopify/InventoryItem/123'].measurement.weight.value"
    ],
    "query_variables": {
      "inventoryItemId": "gid://shopify/InventoryItem/123"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: inventoryItem-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/InventoryItem/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: InventoryItem
  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 = "unstable"

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

  topic = "InventoryItem"
  actions = ["update"]
  triggers = ["inventoryItem.provinceCodeOfOrigin"]

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

  query = """
  query inventoryItem_event_payload($inventoryItemId: ID!) {
    inventoryItem(id: $inventoryItemId) {
      id
      provinceCodeOfOrigin
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "InventoryItem",
    "action": "update",
    "handle": "inventoryItem-event",
    "data": {
      "inventoryItem": {
        "id": "gid://shopify/InventoryItem/123",
        "provinceCodeOfOrigin": "…"
      }
    },
    "fields_changed": [
      "inventoryItem[id: 'gid://shopify/InventoryItem/123'].provinceCodeOfOrigin"
    ],
    "query_variables": {
      "inventoryItemId": "gid://shopify/InventoryItem/123"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: inventoryItem-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/InventoryItem/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: InventoryItem
  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 = "unstable"

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

  topic = "InventoryItem"
  actions = ["update"]
  triggers = ["inventoryItem.requiresShipping"]

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

  query = """
  query inventoryItem_event_payload($inventoryItemId: ID!) {
    inventoryItem(id: $inventoryItemId) {
      id
      requiresShipping
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "InventoryItem",
    "action": "update",
    "handle": "inventoryItem-event",
    "data": {
      "inventoryItem": {
        "id": "gid://shopify/InventoryItem/123",
        "requiresShipping": "…"
      }
    },
    "fields_changed": [
      "inventoryItem[id: 'gid://shopify/InventoryItem/123'].requiresShipping"
    ],
    "query_variables": {
      "inventoryItemId": "gid://shopify/InventoryItem/123"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: inventoryItem-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/InventoryItem/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: InventoryItem
  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 = "unstable"

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

  topic = "InventoryItem"
  actions = ["update"]
  triggers = ["inventoryItem.sku"]

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

  query = """
  query inventoryItem_event_payload($inventoryItemId: ID!) {
    inventoryItem(id: $inventoryItemId) {
      id
      sku
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "InventoryItem",
    "action": "update",
    "handle": "inventoryItem-event",
    "data": {
      "inventoryItem": {
        "id": "gid://shopify/InventoryItem/123",
        "sku": "…"
      }
    },
    "fields_changed": [
      "inventoryItem[id: 'gid://shopify/InventoryItem/123'].sku"
    ],
    "query_variables": {
      "inventoryItemId": "gid://shopify/InventoryItem/123"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: inventoryItem-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/InventoryItem/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: InventoryItem
  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 = "unstable"

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

  topic = "InventoryItem"
  actions = ["update"]
  triggers = ["inventoryItem.tracked"]

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

  query = """
  query inventoryItem_event_payload($inventoryItemId: ID!) {
    inventoryItem(id: $inventoryItemId) {
      id
      tracked
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "InventoryItem",
    "action": "update",
    "handle": "inventoryItem-event",
    "data": {
      "inventoryItem": {
        "id": "gid://shopify/InventoryItem/123",
        "tracked": "…"
      }
    },
    "fields_changed": [
      "inventoryItem[id: 'gid://shopify/InventoryItem/123'].tracked"
    ],
    "query_variables": {
      "inventoryItemId": "gid://shopify/InventoryItem/123"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: inventoryItem-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/InventoryItem/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: InventoryItem
  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 = "unstable"

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

  topic = "InventoryItem"
  actions = ["update"]
  triggers = ["inventoryItem.trackedEditable"]

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

  query = """
  query inventoryItem_event_payload($inventoryItemId: ID!) {
    inventoryItem(id: $inventoryItemId) {
      id
      trackedEditable {
        __typename
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "InventoryItem",
    "action": "update",
    "handle": "inventoryItem-event",
    "data": {
      "inventoryItem": {
        "id": "gid://shopify/InventoryItem/123",
        "trackedEditable": {
          "__typename": "EditableProperty"
        }
      }
    },
    "fields_changed": [
      "inventoryItem[id: 'gid://shopify/InventoryItem/123'].trackedEditable"
    ],
    "query_variables": {
      "inventoryItemId": "gid://shopify/InventoryItem/123"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: inventoryItem-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/InventoryItem/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: InventoryItem
  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 = "unstable"

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

  topic = "InventoryItem"
  actions = ["update"]
  triggers = ["inventoryItem.unitCost"]

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

  query = """
  query inventoryItem_event_payload($inventoryItemId: ID!) {
    inventoryItem(id: $inventoryItemId) {
      id
      unitCost {
        __typename
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "InventoryItem",
    "action": "update",
    "handle": "inventoryItem-event",
    "data": {
      "inventoryItem": {
        "id": "gid://shopify/InventoryItem/123",
        "unitCost": {
          "__typename": "MoneyV2"
        }
      }
    },
    "fields_changed": [
      "inventoryItem[id: 'gid://shopify/InventoryItem/123'].unitCost"
    ],
    "query_variables": {
      "inventoryItemId": "gid://shopify/InventoryItem/123"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: inventoryItem-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/InventoryItem/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: InventoryItem
  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 = "unstable"

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

  topic = "InventoryItem"
  actions = ["update"]
  triggers = ["inventoryItem.variants"]

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

  query = """
  query inventoryItem_event_payload($inventoryItemId: ID!) {
    inventoryItem(id: $inventoryItemId) {
      id
      variants(first: 10) {
        nodes {
          id
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "InventoryItem",
    "action": "update",
    "handle": "inventoryItem-event",
    "data": {
      "inventoryItem": {
        "id": "gid://shopify/InventoryItem/123",
        "variants": {
          "nodes": [
            {
              "id": "gid://shopify/ProductVariant/111"
            }
          ]
        }
      }
    },
    "fields_changed": [
      "inventoryItem[id: 'gid://shopify/InventoryItem/123'].variants"
    ],
    "query_variables": {
      "inventoryItemId": "gid://shopify/InventoryItem/123",
      "variantsId": "gid://shopify/ProductVariant/789"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: inventoryItem-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/InventoryItem/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: InventoryItem
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

***