Aide

Webhook events reference

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

Dernière mise à jour · Intégrations

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.
PrudenceAcknowledge fast and process async. Endpoints that validate against their own database before responding are the top cause of duplicate storms.
Cet article vous a-t-il aidé ?

Articles liés

Toujours bloqué ?

Un agent IA répond maintenant ; un humain peut rejoindre.