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)

New inventory item created

Identified by x-shopify-topic header Resource inventory

shopify-inventory-items-create.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
}

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

Send example to Inspect → View as JSON

inventory_items/delete

documented from Shopify docs (example)

Inventory item is deleted

Identified by x-shopify-topic header Resource inventory

shopify-inventory-items-delete.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"
}

Key fields

Field Type Example
id integer 271878346596884000

Full schema: 6 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

inventory_items/update

documented from Shopify docs (example)

Inventory item details change

Identified by x-shopify-topic header Resource inventory

shopify-inventory-items-update.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
}

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

Send example to Inspect → View as JSON

inventory_levels/connect

documented from Shopify docs (example)

Inventory level is connected

Identified by x-shopify-topic header Resource inventory

shopify-inventory-levels-connect.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 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

Send example to Inspect → View as JSON

inventory_levels/disconnect

documented from Shopify docs (example)

Inventory level is disconnected

Identified by x-shopify-topic header Resource inventory

shopify-inventory-levels-disconnect.json
{
  "inventory_item_id": 271878346596884000,
  "location_id": 24826418
}

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

inventory_levels/update

documented from Shopify docs (example)

Inventory level changes

Identified by x-shopify-topic header Resource inventory

shopify-inventory-levels-update.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 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

Send example to Inspect → View as JSON

inventory_shipments/add_items

documented from Shopify docs (example)

Items added to an inventory shipment

Identified by x-shopify-topic header Resource inventory

shopify-inventory-shipments-add-items.json
{
  "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

Send example to Inspect → View as JSON

inventory_shipments/create

documented from Shopify docs (example)

New inventory shipment created

Identified by x-shopify-topic header Resource inventory

shopify-inventory-shipments-create.json
{
  "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

Send example to Inspect → View as JSON

inventory_shipments/delete

documented from Shopify docs (example)

Inventory shipment is deleted

Identified by x-shopify-topic header Resource inventory

shopify-inventory-shipments-delete.json
{
  "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

Send example to Inspect → View as JSON

inventory_shipments/mark_in_transit

documented from Shopify docs (example)

Inventory shipment marked in transit

Identified by x-shopify-topic header Resource inventory

shopify-inventory-shipments-mark-in-transit.json
{
  "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

Send example to Inspect → View as JSON

inventory_shipments/receive_items

documented from Shopify docs (example)

Items received on an inventory shipment

Identified by x-shopify-topic header Resource inventory

shopify-inventory-shipments-receive-items.json
{
  "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

Send example to Inspect → View as JSON

inventory_shipments/remove_items

documented from Shopify docs (example)

Items removed from an inventory shipment

Identified by x-shopify-topic header Resource inventory

shopify-inventory-shipments-remove-items.json
{
  "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

Send example to Inspect → View as JSON

inventory_shipments/update_item_quantities

documented from Shopify docs (example)

Quantities change on an inventory shipment

Identified by x-shopify-topic header Resource inventory

shopify-inventory-shipments-update-item-quantities.json
{
  "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

Send example to Inspect → View as JSON

inventory_shipments/update_tracking

documented from Shopify docs (example)

Tracking details change on an inventory shipment

Identified by x-shopify-topic header Resource inventory

shopify-inventory-shipments-update-tracking.json
{
  "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

Send example to Inspect → View as JSON

inventory_transfers/add_items

documented from Shopify docs (example)

Items added to an inventory transfer

Identified by x-shopify-topic header Resource inventory

shopify-inventory-transfers-add-items.json
{
  "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

Send example to Inspect → View as JSON

inventory_transfers/cancel

documented from Shopify docs (example)

Inventory transfer is canceled

Identified by x-shopify-topic header Resource inventory

shopify-inventory-transfers-cancel.json
{
  "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

Send example to Inspect → View as JSON

inventory_transfers/complete

documented from Shopify docs (example)

Inventory transfer is completed

Identified by x-shopify-topic header Resource inventory

shopify-inventory-transfers-complete.json
{
  "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

Send example to Inspect → View as JSON

inventory_transfers/ready_to_ship

documented from Shopify docs (example)

Inventory transfer marked ready to ship

Identified by x-shopify-topic header Resource inventory

shopify-inventory-transfers-ready-to-ship.json
{
  "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

Send example to Inspect → View as JSON

inventory_transfers/remove_items

documented from Shopify docs (example)

Items removed from an inventory transfer

Identified by x-shopify-topic header Resource inventory

shopify-inventory-transfers-remove-items.json
{
  "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

Send example to Inspect → View as JSON

inventory_transfers/update_item_quantities

documented from Shopify docs (example)

Line item quantities change on an inventory transfer

Identified by x-shopify-topic header Resource inventory

shopify-inventory-transfers-update-item-quantities.json
{
  "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

Send example to Inspect → View as JSON

inventory_transfers/updated

documented from Shopify docs (example)

Shipment on an inventory transfer created, edited or removed

Identified by x-shopify-topic header Resource inventory

shopify-inventory-transfers-updated.json
{
  "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

Send example to Inspect → View as 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.

Not affiliated with Shopify. Facts are compiled from public sources and linked inline.