Technical Guide
Webhooks technical setup
Configure your endpoint to receive Circle Routes delivery events.
Authentication headers
Content-Type: application/json
X-API-Key: {YOUR_CONFIGURED_KEY}
User-Agent: Circle Routes/1.0
Event types
route_started_initial, stops_upcoming, order_en_route, driver_arrived, delivery_completed, delivery_failed
Customer messaging webhooks are delivery-only. Collection and visit tasks never trigger these events. The task must have a phone number. Tracking URL, proof of delivery, and COD amounts are not on the webhook body — use the tracking page or export for those.