Post a location, ETA or comment update

Append-only. One update per check call, GPS ping or status remark; a permalink already stored is reported as duplicate and not changed. TrackFlo derives the leg's latest location, ETA and comment from these updates.

POST /api/v1/loadupdates/upsert

API key in header X-API-Key

curl 'https://integration-api.trackflo.tech/api/v1/loadupdates/upsert' \
  --request POST \
  --header 'Trackflo-Ingest-Source: pull' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "native_system_load_update_id": "zz1k1rlu15t0dlo1fuevi0",
  "native_system_load_id": "1087189",
  "native_system_load_leg_id": "2326805",
  "native_system_load_permalink": "1087189-acme",
  "native_system_load_leg_permalink": "2326805-acme",
  "native_system_load_update_permalink": "zz1k1rlu15t0dlo1fuevi0-acme",
  "comment": "MacroPoint location update:\nHighway 531 Minden, LA 71055 at 09/06/2026 10:37 AM",
  "load_update_entered_by": "tms-system",
  "latitude": 32.58185,
  "longitude": -93.250547,
  "city": "MINDEN",
  "state": "LA",
  "load_update_utc_timestamp": "2026-09-06T15:37:00",
  "enter_time_utc_timestamp": "2026-09-06T15:38:00",
  "eta_utc": "2026-09-07T04:13:00",
  "eta_local": "2026-09-06T23:13:00",
  "eta_source": "PowerBroker",
  "company_permalink": "acme"
}'

{
  "status": "processed",
  "message": "example",
  "permalink": "example"
}

Stored, skipped or duplicate — see status.

Headers

· 1

Trackflo-Ingest-Source string · enum

pull for scheduled polling, webhook for event-driven pushes. Lets TrackFlo monitor the health of each ingestion path separately; recommended on every request.

values

pull
webhook

Body

· LoadUpdateUpsert

required application/json

native_system_load_update_id string · max length: 100· nullable

Required. Your TMS's id for the check call / location event.

native_system_load_id string · max length: 100· nullable

Required. Your TMS's id of the parent load.

native_system_load_leg_id string · max length: 100· nullable

Required. Your TMS's id of the parent leg.

native_system_load_permalink string · max length: 100· nullable

Required. Unique key of the parent load: -.

native_system_load_leg_permalink string · max length: 100· nullable

Required. Unique key of the parent leg: -. The update is applied to this leg.

native_system_load_update_permalink string · max length: 100 required

Required. Unique key: -. A permalink already stored is a duplicate and is skipped.

comment string · max length: 1000· nullable

Required. Text of the update (check-call note, status remark).

load_update_type string · max length: 100· nullable

Recommended. Kind of update as your TMS names it (e.g. check call, GPS ping, status change).

Headers

Body

Responses