Difference between the orders/updated and orders/edited webhooks

Josh_Davis1
Shopify Partner
9 0 6

Naively these two webhooks sound rather similar. From the somewhat sparse documentation at https://shopify.dev/docs/admin-api/rest/reference/events/webhook, I can see that the message bodies have a different format but I was wondering when exactly these events fire. From some tests I've run it seems that many changes to an order fire orders/updated but not orders/edited. When does orders/edited fire? Is it just for changes to order line items?

0 Likes
james-langille
Shopify Staff
Shopify Staff
39 8 9

Hello, @Josh_Davis1!

I just checked with the orders team and the main difference is that 'orders/edited' is sent when the content of an order changes the value of goods sold (such as when a cross-sell offer is accepted at checkout), and 'orders/updated' changes whenever the order is updated at all (including when an 'orders/edited' webhook is triggered).

I agree that the documentation could be better. I have added this as an item for us to look into.

james-langille | Developer @ Shopify 
 - Was my reply helpful? Click Like to let me know! 
 - Was your question answered? Mark it as an Accepted Solution
 - To learn more visit Shopify.dev or the Shopify Web Design and Development Blog

0 Likes
Josh_Davis1
Shopify Partner
9 0 6

Hi James,

Thank you for the response; that clears it up for me. And thank you for adding the documentation to the to-do list.

-Josh

0 Likes