Skip to content
14-day free trial, no card9 languages176 business types · 50 apps
EN· USD
Try a live demoStart free trial

Courier status webhooks: how it works

A courier can push every status change of a parcel to your workspace the moment it happens, instead of waiting for the half-hourly sync. Each push is checked against a secret, applied once, and never moves a parcel backwards.

Lesson 8 of 12 · How it works

  • about 3 min
  • Deliveries & packing → Couriers → Status webhook

How it works

  1. On Deliveries → Couriers open Status webhook under an API courier and choose Create webhook secret. Copy the webhook address (and the secret) into the courier's merchant panel.

  2. Every push must prove it comes from the courier: a signature made with the secret, the secret in a header, or a secret address, depending on the courier. Anything else is refused.

  3. The parcel is found by its tracking or Consignment A car the owner leaves with the dealer to sell on commission; it stays the owner's until sold and is never the dealer's stock. More words in the glossary number; the Delivery note A paper that lists what goes to the customer, in how many packages and with which courier. The customer signs it on receipt. More words in the glossary then moves out for delivery, delivered or returned, and the cash collected is recorded.

  4. The same push sent twice is applied once. An older report arriving late, or a step backwards, only goes into the parcel's timeline.

  5. Rotate secret makes a new secret at once; enter it at the courier straight away, the old one stops working.

Where to find it

Settings that change it

Checklist

Before you move on, check that you can:

  • Open Deliveries & packing → Couriers → Status webhook
  • On Deliveries → Couriers open Status webhook under an API courier and choose Create webhook secret.
  • Every push must prove it comes from the courier: a signature made with the secret, the secret in a header,…
  • The parcel is found by its tracking or consignment number; the delivery note then moves out for delivery,…
  • The same push sent twice is applied once.

Tips and common mistakes

  • The box shows when the last push arrived and what it did, for example no parcel with that number.
  • The half-hourly sync keeps running, so a missed push is caught up later.
  • Keep the secret private: with the secret-address check the address itself is the secret.