Webhook Events

Event Envelope

Every webhook delivery posts the same envelope:

{
  "event_id": "whd_abc123xyz",
  "event": "<event_name>",
  "data": {},
  "timestamp": 1705312200
}
FieldDescription
event_idStable delivery token. Identical across retries of the same delivery — deduplicate on this.
eventExact event name, e.g. parcel.created or tracking.delivered.
dataEvent payload described per event in Supported Events.
timestampUnix time (seconds) when the event was first sent. Unchanged across retries.

Headers carry X-Webhook-Signature and X-Timestamp (see Verify and Process Events).