Webhooks — send store changes to another app

A webhook endpoint is a web address (it must start with https://) that Ordexs calls the moment something happens in your store, so another app hears about it within seconds. Manage them in Settings → Developers → Webhooks; Integrations → Webhooks explains them and links there.

What can be sent. New orders, order changes, status changes, cancellations, orders that need their address checked, notes added to orders, products created, changed or archived, stock changes, new or changed customers, orders sent to the courier, courier tracking changes (out for delivery, delivered, cash collected, returned), abandoned checkouts (a shopper left their details without ordering, and later changes to it), and new product reviews. Pick the ones you want, or All events (which also includes ones Ordexs adds later).

Adding one. Press Add endpoint, choose Live or Test, paste the address, optionally describe it, and pick the events. Ordexs refuses addresses that point at a private network or at an Ordexs address. Plans allow 2 endpoints on Starter, 5 on Growth and 20 on Scale.

The signing secret. Each endpoint gets a secret, shown once when it's created. The other app uses it to check that requests really come from your store. Rotate secret (in the endpoint's menu) makes a new one; you can keep the old one working for 24 hours or 3 days so the app can switch without missing anything.

Testing. Send test event in the endpoint's menu sends a test request right away.

The delivery log. Show deliveries under an endpoint lists what was sent, whether it arrived, the reply code, how many tries it took and when the next try is. Show what was sent displays the exact content, and Resend sends it again. The log is kept 7 days on Starter, 14 on Growth and 30 on Scale.

When deliveries fail. If the other app doesn't answer with success, Ordexs tries again after about 1 minute, 5 minutes, 30 minutes, 2 hours, 6 hours, then every 12 hours, for up to 3 days. An endpoint where everything has failed for 3 days is turned off automatically: the owner gets an email, and owners and admins get a notification. Fix the address, then choose Turn on in the endpoint's menu. Pause stops an endpoint on purpose.

More in Developers

Still need help?

Ask the assistant from the search box in your dashboard. It answers from these same guides, in English, French or Arabic, and can make changes for you. Or write to us and a person will reply.