# Official list of reasons for inventory\_changes endpoint

**URL:** <https://community.shiphero.com/t/official-list-of-reasons-for-inventory-changes-endpoint/3661>\
**Category:** GraphQL API\
**Created:** [February 23, 2026, 8:49pm UTC](https://community.shiphero.com/t/official-list-of-reasons-for-inventory-changes-endpoint/3661 "2026-02-23T20:49:40Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![techyes](https://avatars.discourse-cdn.com/v4/letter/t/e56c9b/32.png) [@techyes](https://community.shiphero.com/u/techyes)\
**Post date:** [February 23, 2026, 8:49pm UTC](https://community.shiphero.com/t/official-list-of-reasons-for-inventory-changes-endpoint/3661/1 "2026-02-23T20:49:40Z")

</div>

Hello,

I am trying to build an integration between ShipHero and an ERP. I need to pull just the inventory changes that change the total on hand quantity of a SKU but aren’t tied to a standard transaction (order, PO, Return, etc).

We already have Orders and POs syncing between the two systems so it would double the adjustment qty in the ERP if we pulled all inventory changes. So we need to filter them out.

Hope this makes sense and we can get an official list of reasons that we will see.

Thanks,

Jon

---

<div class="post-metadata">

**Author:** ![BilalAhmad](https://avatars.discourse-cdn.com/v4/letter/b/3d9bf3/32.png) [@BilalAhmad](https://community.shiphero.com/u/BilalAhmad)\
**Post date:** [February 28, 2026, 2:24am UTC](https://community.shiphero.com/t/official-list-of-reasons-for-inventory-changes-endpoint/3661/2 "2026-02-28T02:24:03Z")

</div>

Hi @techyes ,

I am also workings on syncing data between shiphero and an ERP, I have synced orders, shipments,POs, workorders into that. Can you elaborate more on what type of transactions need to capture and why certain transactions should be captured?

---

<div class="post-metadata">

**Author:** ![techyes](https://avatars.discourse-cdn.com/v4/letter/t/e56c9b/32.png) [@techyes](https://community.shiphero.com/u/techyes)\
**Post date:** [March 2, 2026, 10:26pm UTC](https://community.shiphero.com/t/official-list-of-reasons-for-inventory-changes-endpoint/3661/3 "2026-03-02T22:26:41Z")

</div>

We need to capture changes to inventory within ShipHero that are not tied to a standard transaction like an order or purchase order for example.

This way the ERP and ShipHero will remain in sync automatically. For example, if someone in the warehouse decides to steal 10 units from a location and adjusts the qty manually, we want to see that adjustment show in the ERP as well so it can be investigated.

Does that help explain?

---

<div class="post-metadata">

**Author:** ![maxorona](https://avatars.discourse-cdn.com/v4/letter/m/e0b2c6/32.png) [@maxorona](https://community.shiphero.com/u/maxorona)\
**Post date:** [March 20, 2026, 5:21pm UTC](https://community.shiphero.com/t/official-list-of-reasons-for-inventory-changes-endpoint/3661/4 "2026-03-20T17:21:24Z")

</div>

You can use the **Inventory\_Change** webhook, and filter (when request is received) by **reason** to exclude those changes related to orders, POs and returns. You will get a webhook request like this:

```auto
{
  "webhook_type": "Inventory Change",
  "account_uuid": "QWNjb3VudDo2Mzg5OA==",
  "account_id": 18963,
  "warehouse_id": 76733,
  "warehouse_uuid": "V2FyZWhvdXNlOjc2NzMz",
  "user_id": 489254,
  "user_uuid": "VXNlcjoxNTg4MjY=",
  "sku": "LOT01",
  "quantity": 10,
  "old_quantity": 0,
  "location_name": "AA-05-01-01",
  "previous_on_hand": 110,
  "timestamp": "2025-02-03 13:19:30", 
  "reason": "Change from the product page via the ShipHero Web Dashboard.",
  "source": "manual",
  "lot_id": 114475,
  "lot_uuid": "TG90OjExNDQ3NQ==",
  "lot_expiration": "2025-03-25"
}

```

More details on

> **[Inventory Change](https://developer.shiphero.com/webhooks/inventory-change-webhook/)**
>
> This webhook is triggered whenever the On Hand quantity changes. Unlike the Inventory Update webhook, which reports the current inventory levels after a change occurs, this webhook is change-centric: it reports the delta itself. The payload includes...

---

<div class="post-metadata">

**Author:** ![techyes](https://avatars.discourse-cdn.com/v4/letter/t/e56c9b/32.png) [@techyes](https://community.shiphero.com/u/techyes)\
**Post date:** [March 20, 2026, 6:54pm UTC](https://community.shiphero.com/t/official-list-of-reasons-for-inventory-changes-endpoint/3661/5 "2026-03-20T18:54:26Z")

</div>

That’s what I’m doing but I’m looking for a list of possible values in the reason field so I can’t properly filter out the ones I don’t want.

---

<div class="post-metadata">

**Author:** ![system](https://us1.discourse-cdn.com/flex020/uploads/shiphero/original/2X/8/83f2a5ec5d7908b156cb6999baa4c753fadfa85d.svg) [@system](https://community.shiphero.com/u/system)\
**Post date:** [June 18, 2026, 6:55pm UTC](https://community.shiphero.com/t/official-list-of-reasons-for-inventory-changes-endpoint/3661/6 "2026-06-18T18:55:24Z")

</div>

This topic was automatically closed 90 days after the last reply. New replies are no longer allowed.