Help

Webhook events reference

Every event 4klyft emits, its payload, and delivery guarantees.

Laatst bijgewerkt · Integraties

Webhooks push shipment, route and claim events to your endpoint as they happen. Configure endpoints and select events under Settings → Integrations → Webhooks.

Event payload

json
{
  "event": "shipment.out_for_delivery",
  "shipment_id": "4K-8829-DE",
  "occurred_at": "2026-08-05T08:12:03+02:00",
  "received_at": "2026-08-05T08:12:04+02:00",
  "delivery_id": "dlv_01J9ZK3W",
  "data": { "route": "AMS-2/14", "eta": "2026-08-05T13:40:00+02:00" }
}

Delivery guarantees

At-least-once delivery — duplicates are possible; deduplicate on delivery_id.
Retries with exponential backoff for 24h on non-2xx responses; a response slower than 8 seconds counts as a failure.
Events from offline devices arrive late but ordered, with the original occurred_at.
Let opAcknowledge fast and process async. Endpoints that validate against their own database before responding are the top cause of duplicate storms.
Was dit nuttig?

Gerelateerde artikelen

Kom je er niet uit?

Een AI-agent antwoordt nu; een mens kan aansluiten.