Skip to main content

Retry and reprocess Shopify webhook events

Shopify sends SKU.io a webhook event each time an order, product or stock level changes. SKU.io records every event and works through it within seconds. When an event fails, for example because the order was being changed by another sync at the same moment, you can find it on the Webhooks page and run it again.

Before you begin​

  • Connect your Shopify store.
  • To run events, you need the Integrations Sync permission (integrations.sync). To delete them, you need the Integrations Edit permission (integrations.update).

What each status means​

The cards at the top of the Events tab count your events by status. Click a card to filter the list to that status. Click it again to clear the filter.

StatusMeaning
PendingThe event has arrived and is waiting its turn.
ProcessingSKU.io is working through the event now.
ProcessedThe event finished. Its changes are in SKU.io.
FailedThe event stopped with an error. Hover over Error in the row to read it.

You usually don't need to act on a failed event. SKU.io tries each event up to three times, a few minutes apart, and also picks up failed events again every 30 minutes. The Attempts column shows how many tries an event has had. An event that has failed three times is left for you.

Processed events are deleted after 14 days. Pending and failed events stay until they're processed or you delete them.

Steps​

Find the event​

  1. Go to Apps & Integrations, open Shopify, and pick your store from the selector at the top.
  2. Click Webhooks. The Events tab opens.
  3. Click the Failed card to list the failed events.
  4. To find the events for one order, type Shopify's ID for the order in Search webhook events.... That's the number at the end of the order's address in Shopify admin, and it shows in the Unique ID column. Use Topic to narrow the list to order events, such as Orders - Updated.
  5. Click the event's number in the ID column to open it. The Processing Error section shows what went wrong, and Payload shows the data Shopify sent.

Run the failed events again​

To run every failed event in one go, click Retry Failed at the top of the list. SKU.io runs each failed event that has had fewer than three attempts and tells you when it's done. Events that already failed three times are skipped, so run those one at a time.

To run one event, use the buttons in its Actions column, or in the event's details:

  • Process Event runs a pending or failed event. SKU.io asks you to confirm, and warns you when the event has been tried before. Click Process.
  • Reprocess Event runs any event again, including one that's already Processed. It doesn't ask first.

To run several events again, tick them in the list and click Reprocess. Choose Selected Only to run the ticked events, or All Filtered to run every event that matches your filters.

Check the result​

  1. Click the refresh button in the toolbar. The event moves to Processed, or back to Failed with a new error.
  2. For an order event, open Orders in the Shopify integration and find the order. The sales order catches up within about a minute.

When to use which action​

UseWhen
Retry FailedSeveral events failed together, for example during a short Shopify outage, and you want to clear them all.
Process PendingEvents are sitting in Pending and you don't want to wait for the next automatic run.
Process EventOne event failed three times, and you've fixed what blocked it, such as a missing product mapping.
Reprocess Event or ReprocessAn event shows Processed, but the order or product in SKU.io doesn't match Shopify, and you want SKU.io to apply that event again.

Each event carries the order as it was when Shopify sent it. When an order has several events, reprocess the newest one, so SKU.io doesn't go back to an older copy of the order.

Why an order never imports twice​

Running an order event again, or Shopify sending the same order twice, doesn't create a second sales order. SKU.io keeps one copy of each Shopify order per store, matched on Shopify's order ID, and only updates that copy when another event arrives. A sales order is created only when that Shopify order doesn't have one yet, and only one creation can run for an order at a time. Once the sales order exists, every later event for that order updates it instead.

So you can retry or reprocess an order event as often as you need. The worst case is that SKU.io applies the same order details again.

Next steps​

Last verified: