Driver Assigned (en_route_pickup)

POST https://my-api.example.com/first-delivery/webhook

status_v3: en_route_pickup · status: Assigned

This is the driver-assignment event: the driver is heading to pickup. Production payloads commonly include driver and location fields from this point onward, but consumers must still treat them as optional because availability varies by provider.

A new en_route_pickup can follow reassign when a replacement driver is assigned. driverPhoneNumber may include a dial-through extension. trackerLinkFleet is the provider tracking page and fleetName is its display name when available.

Request body

{
    "orderId": "5b1f3c20-0e4a-11f1-8c2d-3f9a7e6b1d42",
    "orderNumber": 7414,
    "externalId": "ABC-123456",
    "status": "Assigned",
    "status_v3": "en_route_pickup",
    "driverName": "Jordan P.",
    "driverPhoneNumber": "+15555550123",
    "transportType": "Car",
    "latitude": 40.7411,
    "longitude": -73.9897,
    "estimatedPickupTime": "2026-10-01T13:24:00.000Z",
    "estimatedDropoffTime": "2026-10-01T13:38:00.000Z",
    "trackerLink": "https://trackdelivery.io/?orderId=5b1f3c20-0e4a-11f1-8c2d-3f9a7e6b1d42",
    "dspTrackerLink": "https://track.example-dsp.com/d/8f2c41",
    "trackerLinkFleet": "https://track.example-dsp.com/d/8f2c41",
    "fleetName": "Example Fleet"
}

Examples

cURL

curl --request POST 'https://my-api.example.com/first-delivery/webhook' \
  --header 'Content-Type: application/json' \
  --data '{
    "orderId": "5b1f3c20-0e4a-11f1-8c2d-3f9a7e6b1d42",
    "orderNumber": 7414,
    "externalId": "ABC-123456",
    "status": "Assigned",
    "status_v3": "en_route_pickup",
    "driverName": "Jordan P.",
    "driverPhoneNumber": "+15555550123",
    "transportType": "Car",
    "latitude": 40.7411,
    "longitude": -73.9897,
    "estimatedPickupTime": "2026-10-01T13:24:00.000Z",
    "estimatedDropoffTime": "2026-10-01T13:38:00.000Z",
    "trackerLink": "https://trackdelivery.io/?orderId=5b1f3c20-0e4a-11f1-8c2d-3f9a7e6b1d42",
    "dspTrackerLink": "https://track.example-dsp.com/d/8f2c41",
    "trackerLinkFleet": "https://track.example-dsp.com/d/8f2c41",
    "fleetName": "Example Fleet"
}'

Node.js

const response = await fetch("https://my-api.example.com/first-delivery/webhook", {
  "method": "POST",
  "headers": {
    "Content-Type": "application/json"
  },
  "body": "{\n    \"orderId\": \"5b1f3c20-0e4a-11f1-8c2d-3f9a7e6b1d42\",\n    \"orderNumber\": 7414,\n    \"externalId\": \"ABC-123456\",\n    \"status\": \"Assigned\",\n    \"status_v3\": \"en_route_pickup\",\n    \"driverName\": \"Jordan P.\",\n    \"driverPhoneNumber\": \"+15555550123\",\n    \"transportType\": \"Car\",\n    \"latitude\": 40.7411,\n    \"longitude\": -73.9897,\n    \"estimatedPickupTime\": \"2026-10-01T13:24:00.000Z\",\n    \"estimatedDropoffTime\": \"2026-10-01T13:38:00.000Z\",\n    \"trackerLink\": \"https://trackdelivery.io/?orderId=5b1f3c20-0e4a-11f1-8c2d-3f9a7e6b1d42\",\n    \"dspTrackerLink\": \"https://track.example-dsp.com/d/8f2c41\",\n    \"trackerLinkFleet\": \"https://track.example-dsp.com/d/8f2c41\",\n    \"fleetName\": \"Example Fleet\"\n}"
})
const data = await response.json()

Python

import requests

response = requests.request(
    "POST",
    "https://my-api.example.com/first-delivery/webhook",
    headers={
  'Content-Type': 'application/json'
},
    data="{\n    \"orderId\": \"5b1f3c20-0e4a-11f1-8c2d-3f9a7e6b1d42\",\n    \"orderNumber\": 7414,\n    \"externalId\": \"ABC-123456\",\n    \"status\": \"Assigned\",\n    \"status_v3\": \"en_route_pickup\",\n    \"driverName\": \"Jordan P.\",\n    \"driverPhoneNumber\": \"+15555550123\",\n    \"transportType\": \"Car\",\n    \"latitude\": 40.7411,\n    \"longitude\": -73.9897,\n    \"estimatedPickupTime\": \"2026-10-01T13:24:00.000Z\",\n    \"estimatedDropoffTime\": \"2026-10-01T13:38:00.000Z\",\n    \"trackerLink\": \"https://trackdelivery.io/?orderId=5b1f3c20-0e4a-11f1-8c2d-3f9a7e6b1d42\",\n    \"dspTrackerLink\": \"https://track.example-dsp.com/d/8f2c41\",\n    \"trackerLinkFleet\": \"https://track.example-dsp.com/d/8f2c41\",\n    \"fleetName\": \"Example Fleet\"\n}",
)
response.raise_for_status()