Webhook Limitations

Keep these limitations in mind when you design your app:

  • Delivery isn't guaranteed. Run a reconciliation job (periodic polling) that fetches recent changes from the API, so your app doesn't rely on webhooks alone.
  • Delivery can be delayed, especially when there's a surge of traffic.
  • Webhooks can arrive out of order or more than once. There's no event ID, so compare timestamps such as updated_at before overwriting newer data.
  • Failed deliveries are retried for up to 2 days. After that, the event is dropped.
  • Only 200 OK counts as success. Redirects and other 2xx codes are treated as failures.

See Respond and retries for details.

icon-accounticon-add-newicon-add-storeicon-appicon-appleicon-archiveicon-arrowdownicon-ascicon-bookicon-cancelicon-cart-addonicon-checkouticon-cherryicon-collectionicon-comfirmicon-confirmicon-couponicon-creditsicon-currencyicon-dashboardicon-discounticon-disintegrateicon-domainicon-dscicon-duplicateicon-editicon-emailicon-exclamation-triangleicon-exporticon-eyeicon-eye-slashicon-fullscreenicon-fullscreen-closeicon-generalicon-gifticon-gridicon-hddicon-helpicon-importicon-infoicon-integrationicon-invoiceicon-likeicon-listicon-locationicon-logouticon-new-tabicon-not-secureicon-optionicon-ordericon-outline-arrowdownicon-pageicon-paymenticon-plusicon-posicon-pricingicon-printericon-producticon-product-sumicon-product-sum-xicon-redirecticon-reporticon-reseticon-searchicon-secureicon-settingicon-shippingicon-staricon-storeicon-switch-storeicon-tagicon-taxesicon-templateicon-themeicon-tickicon-trashicon-unarchiveicon-uploadicon-user-tagicon-usersicon-weighticon-wholesale