# Shopify inventory webhook events

Shopify sends 21 inventory events across items, levels, shipments and transfers. `inventory_levels/update` reports a change to an inventory level, and it's the one most integrations use. Every event here can also reach agents as an MCP event through Hookdeck: [MCP events](https://hookdeck.com/webhooks/shopify/mcp-events).

Agent skill: `npx skills add hookdeck/webhook-skills --skill shopify-webhooks` ([details](https://hookdeck.com/webhooks/shopify/skill))

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [Shopify's official docs](https://shopify.dev/docs/apps/build/webhooks/delivery-structure).

[Overview](https://hookdeck.com/webhooks/shopify) · [Webhook events (230)](https://hookdeck.com/webhooks/shopify/events) · [MCP events](https://hookdeck.com/webhooks/shopify/mcp-events) · [Verify signatures](https://hookdeck.com/webhooks/shopify/verify) · [Production guide](https://hookdeck.com/webhooks/shopify/guide-duplicates-ordering-retries-timeouts) · [Agent skill](https://hookdeck.com/webhooks/shopify/skill)

## inventory_items/create

Confidence: documented · Schema: from Shopify docs (example)

New inventory item created

Identified by: x-shopify-topic header · Object: `inventory`

```json
{
  "id": 271878346596884000,
  "sku": "example-sku",
  "created_at": "2023-02-20T20:45:39-05:00",
  "updated_at": "2023-02-20T20:45:39-05:00",
  "requires_shipping": true,
  "cost": null,
  "country_code_of_origin": null,
  "province_code_of_origin": null,
  "harmonized_system_code": null,
  "tracked": true
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-items-create.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `271878346596884000` |
| `created_at` | string | `2023-02-20T20:45:39-05:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-items-create.json)

## inventory_items/delete

Confidence: documented · Schema: from Shopify docs (example)

Inventory item is deleted

Identified by: x-shopify-topic header · Object: `inventory`

```json
{
  "id": 271878346596884000,
  "country_code_of_origin": null,
  "province_code_of_origin": null,
  "harmonized_system_code": null,
  "country_harmonized_system_codes": [ … ],
  "admin_graphql_api_id": "gid://shopify/InventoryItem/271878346596884015"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-items-delete.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `271878346596884000` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-items-delete.json)

## inventory_items/update

Confidence: documented · Schema: from Shopify docs (example)

Inventory item details change

Identified by: x-shopify-topic header · Object: `inventory`

```json
{
  "id": 271878346596884000,
  "sku": "example-sku",
  "created_at": "2023-02-20T20:45:45-05:00",
  "updated_at": "2023-02-20T20:45:45-05:00",
  "requires_shipping": true,
  "cost": null,
  "country_code_of_origin": null,
  "province_code_of_origin": null,
  "harmonized_system_code": null,
  "tracked": true
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-items-update.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `271878346596884000` |
| `created_at` | string | `2023-02-20T20:45:45-05:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-items-update.json)

## inventory_levels/connect

Confidence: documented · Schema: from Shopify docs (example)

Inventory level is connected

Identified by: x-shopify-topic header · Object: `inventory`

```json
{
  "inventory_item_id": 271878346596884000,
  "location_id": 65616216276,
  "available": null,
  "updated_at": "2023-02-20T20:45:48-05:00",
  "admin_graphql_api_id": "gid://shopify/InventoryLevel/99953246420?inventory_item_id=271878346596884015"
}
```



| Key field | Type | Example |
|---|---|---|
| `updated_at` | string | `2023-02-20T20:45:48-05:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-levels-connect.json)

## inventory_levels/disconnect

Confidence: documented · Schema: from Shopify docs (example)

Inventory level is disconnected

Identified by: x-shopify-topic header · Object: `inventory`

```json
{
  "inventory_item_id": 271878346596884000,
  "location_id": 24826418
}
```



From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-levels-disconnect.json)

## inventory_levels/update

Confidence: documented · Schema: from Shopify docs (example)

Inventory level changes

Identified by: x-shopify-topic header · Object: `inventory`

```json
{
  "inventory_item_id": 271878346596884000,
  "location_id": 65616216276,
  "available": null,
  "updated_at": "2023-02-20T20:47:32-05:00",
  "admin_graphql_api_id": "gid://shopify/InventoryLevel/99953246420?inventory_item_id=271878346596884015"
}
```



| Key field | Type | Example |
|---|---|---|
| `updated_at` | string | `2023-02-20T20:47:32-05:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-levels-update.json)

## inventory_shipments/add_items

Confidence: documented · Schema: from Shopify docs (example)

Items added to an inventory shipment

Identified by: x-shopify-topic header · Object: `inventory`

```json
{
  "id": "gid://shopify/InventoryShipment/3921201",
  "items_added": [ … ],
  "happened_at": "2023-09-01T08:19:56-04:00"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-shipments-add-items.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `gid://shopify/InventoryShipment/3921201` |
| `happened_at` | string | `2023-09-01T08:19:56-04:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-shipments-add-items.json)

## inventory_shipments/create

Confidence: documented · Schema: from Shopify docs (example)

New inventory shipment created

Identified by: x-shopify-topic header · Object: `inventory`

```json
{
  "id": "gid://shopify/InventoryShipment/3921201",
  "status": "DRAFT",
  "happened_at": "2023-09-01T08:19:56-04:00",
  "tracking": { … },
  "line_items": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-shipments-create.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `gid://shopify/InventoryShipment/3921201` |
| `status` | string | `DRAFT` |
| `happened_at` | string | `2023-09-01T08:19:56-04:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-shipments-create.json)

## inventory_shipments/delete

Confidence: documented · Schema: from Shopify docs (example)

Inventory shipment is deleted

Identified by: x-shopify-topic header · Object: `inventory`

```json
{
  "id": "gid://shopify/InventoryShipment/3921201",
  "happened_at": "2023-09-01T08:19:56-04:00"
}
```



| Key field | Type | Example |
|---|---|---|
| `id` | string | `gid://shopify/InventoryShipment/3921201` |
| `happened_at` | string | `2023-09-01T08:19:56-04:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-shipments-delete.json)

## inventory_shipments/mark_in_transit

Confidence: documented · Schema: from Shopify docs (example)

Inventory shipment marked in transit

Identified by: x-shopify-topic header · Object: `inventory`

```json
{
  "id": "gid://shopify/InventoryShipment/3921201",
  "status": "IN_TRANSIT",
  "happened_at": "2023-09-01T08:19:56-04:00"
}
```



| Key field | Type | Example |
|---|---|---|
| `id` | string | `gid://shopify/InventoryShipment/3921201` |
| `status` | string | `IN_TRANSIT` |
| `happened_at` | string | `2023-09-01T08:19:56-04:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-shipments-mark-in-transit.json)

## inventory_shipments/receive_items

Confidence: documented · Schema: from Shopify docs (example)

Items received on an inventory shipment

Identified by: x-shopify-topic header · Object: `inventory`

```json
{
  "id": "gid://shopify/InventoryShipment/3921201",
  "status": "PARTIALLY_RECEIVED",
  "items_received": [ … ],
  "happened_at": "2023-09-01T08:19:56-04:00"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-shipments-receive-items.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `gid://shopify/InventoryShipment/3921201` |
| `status` | string | `PARTIALLY_RECEIVED` |
| `happened_at` | string | `2023-09-01T08:19:56-04:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-shipments-receive-items.json)

## inventory_shipments/remove_items

Confidence: documented · Schema: from Shopify docs (example)

Items removed from an inventory shipment

Identified by: x-shopify-topic header · Object: `inventory`

```json
{
  "id": "gid://shopify/InventoryShipment/3921201",
  "items_removed": [ … ],
  "happened_at": "2023-09-01T08:19:56-04:00"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-shipments-remove-items.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `gid://shopify/InventoryShipment/3921201` |
| `happened_at` | string | `2023-09-01T08:19:56-04:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-shipments-remove-items.json)

## inventory_shipments/update_item_quantities

Confidence: documented · Schema: from Shopify docs (example)

Quantities change on an inventory shipment

Identified by: x-shopify-topic header · Object: `inventory`

```json
{
  "id": "gid://shopify/InventoryShipment/3921201",
  "items_updated": [ … ],
  "happened_at": "2023-09-01T08:19:56-04:00"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-shipments-update-item-quantities.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `gid://shopify/InventoryShipment/3921201` |
| `happened_at` | string | `2023-09-01T08:19:56-04:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-shipments-update-item-quantities.json)

## inventory_shipments/update_tracking

Confidence: documented · Schema: from Shopify docs (example)

Tracking details change on an inventory shipment

Identified by: x-shopify-topic header · Object: `inventory`

```json
{
  "shipment_id": "gid://shopify/InventoryShipment/3921201",
  "updated_tracking": { … },
  "happened_at": "2023-09-01T08:19:56-04:00"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-shipments-update-tracking.json)

| Key field | Type | Example |
|---|---|---|
| `happened_at` | string | `2023-09-01T08:19:56-04:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-shipments-update-tracking.json)

## inventory_transfers/add_items

Confidence: documented · Schema: from Shopify docs (example)

Items added to an inventory transfer

Identified by: x-shopify-topic header · Object: `inventory`

```json
{
  "id": "gid://shopify/InventoryTransfer/2921201",
  "happened_at": "2023-09-01T08:19:56-04:00",
  "origin": { … },
  "destination": { … },
  "items_added": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-transfers-add-items.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `gid://shopify/InventoryTransfer/2921201` |
| `happened_at` | string | `2023-09-01T08:19:56-04:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-transfers-add-items.json)

## inventory_transfers/cancel

Confidence: documented · Schema: from Shopify docs (example)

Inventory transfer is canceled

Identified by: x-shopify-topic header · Object: `inventory`

```json
{
  "id": "gid://shopify/InventoryTransfer/2921201",
  "happened_at": "2023-09-01T08:19:56-04:00",
  "origin": { … },
  "destination": { … },
  "status": "CANCELED"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-transfers-cancel.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `gid://shopify/InventoryTransfer/2921201` |
| `status` | string | `CANCELED` |
| `happened_at` | string | `2023-09-01T08:19:56-04:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-transfers-cancel.json)

## inventory_transfers/complete

Confidence: documented · Schema: from Shopify docs (example)

Inventory transfer is completed

Identified by: x-shopify-topic header · Object: `inventory`

```json
{
  "id": "gid://shopify/InventoryTransfer/2921201",
  "happened_at": "2023-09-01T08:19:56-04:00",
  "origin": { … },
  "destination": { … },
  "status": "TRANSFERRED"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-transfers-complete.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `gid://shopify/InventoryTransfer/2921201` |
| `status` | string | `TRANSFERRED` |
| `happened_at` | string | `2023-09-01T08:19:56-04:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-transfers-complete.json)

## inventory_transfers/ready_to_ship

Confidence: documented · Schema: from Shopify docs (example)

Inventory transfer marked ready to ship

Identified by: x-shopify-topic header · Object: `inventory`

```json
{
  "id": "gid://shopify/InventoryTransfer/2921201",
  "happened_at": "2023-09-01T08:19:56-04:00",
  "origin": { … },
  "destination": { … },
  "status": "READY_TO_SHIP",
  "line_items": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-transfers-ready-to-ship.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `gid://shopify/InventoryTransfer/2921201` |
| `status` | string | `READY_TO_SHIP` |
| `happened_at` | string | `2023-09-01T08:19:56-04:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-transfers-ready-to-ship.json)

## inventory_transfers/remove_items

Confidence: documented · Schema: from Shopify docs (example)

Items removed from an inventory transfer

Identified by: x-shopify-topic header · Object: `inventory`

```json
{
  "id": "gid://shopify/InventoryTransfer/2921201",
  "happened_at": "2023-09-01T08:19:56-04:00",
  "origin": { … },
  "destination": { … },
  "items_removed": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-transfers-remove-items.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `gid://shopify/InventoryTransfer/2921201` |
| `happened_at` | string | `2023-09-01T08:19:56-04:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-transfers-remove-items.json)

## inventory_transfers/update_item_quantities

Confidence: documented · Schema: from Shopify docs (example)

Line item quantities change on an inventory transfer

Identified by: x-shopify-topic header · Object: `inventory`

```json
{
  "id": "gid://shopify/InventoryTransfer/2921201",
  "happened_at": "2023-09-01T08:19:56-04:00",
  "origin": { … },
  "destination": { … },
  "status": "IN_PROGRESS",
  "items_updated": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-transfers-update-item-quantities.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `gid://shopify/InventoryTransfer/2921201` |
| `status` | string | `IN_PROGRESS` |
| `happened_at` | string | `2023-09-01T08:19:56-04:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-transfers-update-item-quantities.json)

## inventory_transfers/updated

Confidence: documented · Schema: from Shopify docs (example)

Shipment on an inventory transfer created, edited or removed

Identified by: x-shopify-topic header · Object: `inventory`

```json
{
  "id": "gid://shopify/InventoryTransfer/2921201",
  "happened_at": "2023-09-01T08:19:56-04:00",
  "origin": { … },
  "destination": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-transfers-updated.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `gid://shopify/InventoryTransfer/2921201` |
| `happened_at` | string | `2023-09-01T08:19:56-04:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/inventory-transfers-updated.json)

---

Not affiliated with Shopify. Facts are compiled from public sources and linked inline. [View as JSON](https://hookdeck.com/webhooks/shopify.json) · [Report a correction](https://hookdeck.com/contact)
