Technical Guide
API technical setup
Use these core endpoints to integrate external systems with Circle Routes.
Core endpoint
POST {YOUR_API_HOST}/api/v1/delivery-tasks/push
Authentication
Header: X-API-Key: {your API key from Settings → API Integration}
Optional B2B client tag
Add shipper_client on each task (same value as the spreadsheet Shipper Client column) when pushing for multiple clients. Per-client push uses POST /api/v1/shipper-clients/push/deliveries with X-Shipper-API-Key — see the developer guide.
Optional task type
Send task_type as delivery (default) or collection. Collections created via the API are standalone only — no AWB, tracking link, or customer messaging. Same-visit collections are driver-only. See the developer guide and Push API field table for full details.