Fulfillment_orders/merged webhook not triggered on Shopify auto-merge

Webhooks and Events
1

Hi Shopify team,

I’ve run into an issue with fulfillment order webhooks that seems like a gap between documented behavior and actual behavior.

What I’m seeing:

  • When I manually merge fulfillment orders through the Shopify Admin, I receive the fulfillment_orders/merged webhook as expected.

  • When my system (or an app) explicitly calls the fulfillmentOrderMerge mutation, I also receive the fulfillment_orders/merged webhook.

  • However, when Shopify automatically merges fulfillment orders (e.g., when a customer changes the fulfillment location to one that matches an existing fulfillment order, and Shopify auto-merges them), no fulfillment_orders/merged webhook is sent.

Why this matters:
My fulfillment service integrates tightly with Shopify. For example, when a customer changes the fulfillment location to my warehouse, Shopify auto-merges the fulfillment orders. Since the webhook is not triggered in this scenario, my OMS never knows about the merge, leaving my fulfillment state out of sync.

Expected behavior:
The fulfillment_orders/merged webhook should fire in all merge cases (manual, API-initiated, and auto-merge by Shopify), or Shopify should clearly document that auto-merges do not emit this event.

Impact:
This gap prevents external fulfillment/OMS systems from keeping an accurate and real-time view of fulfillment orders when Shopify auto-merges them.

Request:

  • Can Shopify confirm if this is an intentional limitation or a bug?

  • If intentional, is there a recommended workaround to detect auto-merges in real time (other than polling the FulfillmentOrder API)?

Thanks in advance for your help.

1 Like
2

Hey @Jimmy_Zhang , this sounds like a scope issue. I tested this by creating fulfillment orders with and without read_third_party_fulfillment_orders. Without that scope, the webhook didn’t fire when manually merging into an app-managed location. Adding read_third_party_fulfillment_orders fixed it immediately.

That said, I couldn’t replicate the auto-merge behavior. When I changed fulfillment locations on split orders, it wasn’t merged automatically, instead I still had to select to merge them in the admin. Is that the auto merge behaviour you’re mentioning?

3

Hey @Jimmy_Zhang, are you still experiencing this issue, or can I mark this as solved?