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 examples

route_started_initial, stops_upcoming, delivery_completed, delivery_failed

Customer messaging webhooks are delivery-only. Collection tasks never trigger these events (no tracking link, no completion SMS/email for collections).

Back to integrations