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 →
inventory_items/create
documented from Shopify docs (example)
inventory_items/create New inventory item created
Identified by x-shopify-topic header
Resource inventory
{
"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
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 271878346596884000 |
created_at | string | 2023-02-20T20:45:39-05:00 |
Full schema: 14 fields.
From Shopify docs
-
Content type
application/json
inventory_items/delete
documented from Shopify docs (example)
inventory_items/delete Inventory item is deleted
Identified by x-shopify-topic header
Resource inventory
{
"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"
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 271878346596884000 |
Full schema: 6 fields.
From Shopify docs
-
Content type
application/json
inventory_items/update
documented from Shopify docs (example)
inventory_items/update Inventory item details change
Identified by x-shopify-topic header
Resource inventory
{
"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
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 271878346596884000 |
created_at | string | 2023-02-20T20:45:45-05:00 |
Full schema: 14 fields.
From Shopify docs
-
Content type
application/json
inventory_levels/connect
documented from Shopify docs (example)
inventory_levels/connect Inventory level is connected
Identified by x-shopify-topic header
Resource inventory
{
"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 fields
| Field | Type | Example |
|---|---|---|
updated_at | string | 2023-02-20T20:45:48-05:00 |
Full schema: 5 fields.
From Shopify docs
-
Content type
application/json
inventory_levels/disconnect
documented from Shopify docs (example)
inventory_levels/disconnect Inventory level is disconnected
Identified by x-shopify-topic header
Resource inventory
{
"inventory_item_id": 271878346596884000,
"location_id": 24826418
} From Shopify docs
-
Content type
application/json
inventory_levels/update
documented from Shopify docs (example)
inventory_levels/update Inventory level changes
Identified by x-shopify-topic header
Resource inventory
{
"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 fields
| Field | Type | Example |
|---|---|---|
updated_at | string | 2023-02-20T20:47:32-05:00 |
Full schema: 5 fields.
From Shopify docs
-
Content type
application/json
inventory_shipments/add_items
documented from Shopify docs (example)
inventory_shipments/add_items Items added to an inventory shipment
Identified by x-shopify-topic header
Resource inventory
{
"id": "gid://shopify/InventoryShipment/3921201",
"items_added": [ … ],
"happened_at": "2023-09-01T08:19:56-04:00"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | gid://shopify/InventoryShipment/3921201 |
happened_at | string | 2023-09-01T08:19:56-04:00 |
Full schema: 6 fields.
From Shopify docs
-
Content type
application/json
inventory_shipments/create
documented from Shopify docs (example)
inventory_shipments/create New inventory shipment created
Identified by x-shopify-topic header
Resource inventory
{
"id": "gid://shopify/InventoryShipment/3921201",
"status": "DRAFT",
"happened_at": "2023-09-01T08:19:56-04:00",
"tracking": { … },
"line_items": [ … ]
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | gid://shopify/InventoryShipment/3921201 |
status | string | DRAFT |
happened_at | string | 2023-09-01T08:19:56-04:00 |
Full schema: 12 fields.
From Shopify docs
-
Content type
application/json
inventory_shipments/delete
documented from Shopify docs (example)
inventory_shipments/delete Inventory shipment is deleted
Identified by x-shopify-topic header
Resource inventory
{
"id": "gid://shopify/InventoryShipment/3921201",
"happened_at": "2023-09-01T08:19:56-04:00"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | gid://shopify/InventoryShipment/3921201 |
happened_at | string | 2023-09-01T08:19:56-04:00 |
Full schema: 2 fields.
From Shopify docs
-
Content type
application/json
inventory_shipments/mark_in_transit
documented from Shopify docs (example)
inventory_shipments/mark_in_transit Inventory shipment marked in transit
Identified by x-shopify-topic header
Resource inventory
{
"id": "gid://shopify/InventoryShipment/3921201",
"status": "IN_TRANSIT",
"happened_at": "2023-09-01T08:19:56-04:00"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | gid://shopify/InventoryShipment/3921201 |
status | string | IN_TRANSIT |
happened_at | string | 2023-09-01T08:19:56-04:00 |
Full schema: 3 fields.
From Shopify docs
-
Content type
application/json
inventory_shipments/receive_items
documented from Shopify docs (example)
inventory_shipments/receive_items Items received on an inventory shipment
Identified by x-shopify-topic header
Resource inventory
{
"id": "gid://shopify/InventoryShipment/3921201",
"status": "PARTIALLY_RECEIVED",
"items_received": [ … ],
"happened_at": "2023-09-01T08:19:56-04:00"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | gid://shopify/InventoryShipment/3921201 |
status | string | PARTIALLY_RECEIVED |
happened_at | string | 2023-09-01T08:19:56-04:00 |
Full schema: 11 fields.
From Shopify docs
-
Content type
application/json
inventory_shipments/remove_items
documented from Shopify docs (example)
inventory_shipments/remove_items Items removed from an inventory shipment
Identified by x-shopify-topic header
Resource inventory
{
"id": "gid://shopify/InventoryShipment/3921201",
"items_removed": [ … ],
"happened_at": "2023-09-01T08:19:56-04:00"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | gid://shopify/InventoryShipment/3921201 |
happened_at | string | 2023-09-01T08:19:56-04:00 |
Full schema: 5 fields.
From Shopify docs
-
Content type
application/json
inventory_shipments/update_item_quantities
documented from Shopify docs (example)
inventory_shipments/update_item_quantities Quantities change on an inventory shipment
Identified by x-shopify-topic header
Resource inventory
{
"id": "gid://shopify/InventoryShipment/3921201",
"items_updated": [ … ],
"happened_at": "2023-09-01T08:19:56-04:00"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | gid://shopify/InventoryShipment/3921201 |
happened_at | string | 2023-09-01T08:19:56-04:00 |
Full schema: 7 fields.
From Shopify docs
-
Content type
application/json
inventory_shipments/update_tracking
documented from Shopify docs (example)
inventory_shipments/update_tracking Tracking details change on an inventory shipment
Identified by x-shopify-topic header
Resource inventory
{
"shipment_id": "gid://shopify/InventoryShipment/3921201",
"updated_tracking": { … },
"happened_at": "2023-09-01T08:19:56-04:00"
} Key fields
| Field | Type | Example |
|---|---|---|
happened_at | string | 2023-09-01T08:19:56-04:00 |
Full schema: 7 fields.
From Shopify docs
-
Content type
application/json
inventory_transfers/add_items
documented from Shopify docs (example)
inventory_transfers/add_items Items added to an inventory transfer
Identified by x-shopify-topic header
Resource inventory
{
"id": "gid://shopify/InventoryTransfer/2921201",
"happened_at": "2023-09-01T08:19:56-04:00",
"origin": { … },
"destination": { … },
"items_added": [ … ]
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | gid://shopify/InventoryTransfer/2921201 |
happened_at | string | 2023-09-01T08:19:56-04:00 |
Full schema: 10 fields.
From Shopify docs
-
Content type
application/json
inventory_transfers/cancel
documented from Shopify docs (example)
inventory_transfers/cancel Inventory transfer is canceled
Identified by x-shopify-topic header
Resource inventory
{
"id": "gid://shopify/InventoryTransfer/2921201",
"happened_at": "2023-09-01T08:19:56-04:00",
"origin": { … },
"destination": { … },
"status": "CANCELED"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | gid://shopify/InventoryTransfer/2921201 |
status | string | CANCELED |
happened_at | string | 2023-09-01T08:19:56-04:00 |
Full schema: 7 fields.
From Shopify docs
-
Content type
application/json
inventory_transfers/complete
documented from Shopify docs (example)
inventory_transfers/complete Inventory transfer is completed
Identified by x-shopify-topic header
Resource inventory
{
"id": "gid://shopify/InventoryTransfer/2921201",
"happened_at": "2023-09-01T08:19:56-04:00",
"origin": { … },
"destination": { … },
"status": "TRANSFERRED"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | gid://shopify/InventoryTransfer/2921201 |
status | string | TRANSFERRED |
happened_at | string | 2023-09-01T08:19:56-04:00 |
Full schema: 7 fields.
From Shopify docs
-
Content type
application/json
inventory_transfers/ready_to_ship
documented from Shopify docs (example)
inventory_transfers/ready_to_ship Inventory transfer marked ready to ship
Identified by x-shopify-topic header
Resource inventory
{
"id": "gid://shopify/InventoryTransfer/2921201",
"happened_at": "2023-09-01T08:19:56-04:00",
"origin": { … },
"destination": { … },
"status": "READY_TO_SHIP",
"line_items": [ … ]
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | gid://shopify/InventoryTransfer/2921201 |
status | string | READY_TO_SHIP |
happened_at | string | 2023-09-01T08:19:56-04:00 |
Full schema: 11 fields.
From Shopify docs
-
Content type
application/json
inventory_transfers/remove_items
documented from Shopify docs (example)
inventory_transfers/remove_items Items removed from an inventory transfer
Identified by x-shopify-topic header
Resource inventory
{
"id": "gid://shopify/InventoryTransfer/2921201",
"happened_at": "2023-09-01T08:19:56-04:00",
"origin": { … },
"destination": { … },
"items_removed": [ … ]
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | gid://shopify/InventoryTransfer/2921201 |
happened_at | string | 2023-09-01T08:19:56-04:00 |
Full schema: 9 fields.
From Shopify docs
-
Content type
application/json
inventory_transfers/update_item_quantities
documented from Shopify docs (example)
inventory_transfers/update_item_quantities Line item quantities change on an inventory transfer
Identified by x-shopify-topic header
Resource inventory
{
"id": "gid://shopify/InventoryTransfer/2921201",
"happened_at": "2023-09-01T08:19:56-04:00",
"origin": { … },
"destination": { … },
"status": "IN_PROGRESS",
"items_updated": [ … ]
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | gid://shopify/InventoryTransfer/2921201 |
status | string | IN_PROGRESS |
happened_at | string | 2023-09-01T08:19:56-04:00 |
Full schema: 12 fields.
From Shopify docs
-
Content type
application/json
inventory_transfers/updated
documented from Shopify docs (example)
inventory_transfers/updated Shipment on an inventory transfer created, edited or removed
Identified by x-shopify-topic header
Resource inventory
{
"id": "gid://shopify/InventoryTransfer/2921201",
"happened_at": "2023-09-01T08:19:56-04:00",
"origin": { … },
"destination": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | gid://shopify/InventoryTransfer/2921201 |
happened_at | string | 2023-09-01T08:19:56-04:00 |
Full schema: 6 fields.
From Shopify docs
-
Content type
application/json
Route Shopify events by type.
Event Gateway receives every Shopify delivery and filters and routes it by event type, so each service gets only the events it handles.