Driver, Equipment and Tracking Endpoint

Updated today

Save the driver, truck, trailer and carrier tracking link on the movement named in native_system_load_leg_id. We send one whenever any of them is added or changed in TrackFlo, whether a tracker typed it or it was approved from a carrier's email or a driver's text.

Suggested path: POST /trackflo/driver-info. Authentication, the shared fields, responses and retries are in Build Write-Back Endpoints for TrackFlo.

Fields

Every request carries the shared fields plus these. event_type is driver_info.

Field	Type	Description
`driver_name`	string or null	The driver's name.
`driver_phone_number`	string or null	The driver's mobile number in E.164 format, for example `+15125550142`.
`driver_2_name`	string or null	The second driver on a team load.
`driver_2_phone_number`	string or null	The second driver's mobile number, E.164.
`driving_type`	string or null	`single` or `team`.
`truck_number`	string or null	The tractor or power unit number.
`trailer_number`	string or null	The trailer number.
`tracking_url`	string or null	The carrier's tracking link for this load, such as a carrier portal, MacroPoint or Trucker Tools link.

Example

{
  "event_id": "3e8f5a21-9c64-4b7d-b0e2-d15a7c6f9e40",
  "event_type": "driver_info",
  "native_system_load_id": "1089520",
  "native_system_load_leg_id": "2330158",
  "entered_by_name": "TrackFlo Automation & AI",
  "entered_by_email": null,
  "entered_by_tms_user_id": null,
  "entered_at_utc": "2026-10-24T09:12:31Z",
  "trackflo_load_url": "https://app.trackflo.tech/public_load_details/4b6e…",
  "driver_name": "Marcus Reed",
  "driver_phone_number": "+15125550142",
  "driver_2_name": null,
  "driver_2_phone_number": null,
  "driving_type": "single",
  "truck_number": "4417",
  "trailer_number": "53R-2208",
  "tracking_url": "https://carrier-portal.example.com/track/8XK2"
}

Respond with { "id": "<your record id>" }, or { "id": null } if the values are fields on the movement rather than a record of their own.

Applying driver info

Every request carries the full current set. You don't need to merge partial updates: each request has every field TrackFlo holds for the leg.
Null means we don't have it. Don't overwrite a value you hold with a null. We never send a request to clear a field.
Apply only the newest. If a retried request arrives after a newer one, its entered_at_utc is older than the one you applied. Skip it.
Write to the carrier on this leg. On a split order each leg has its own carrier, driver and equipment.

Was this helpful?