---
title: "Add a tracking event"
method: POST
path: "/v2/loads/tracking"
tags: ["Load Management"]
---

# Add a tracking event

`POST /v2/loads/tracking`

## Request

- Base URL: `https://api.prod.goaugment.com`
- URL: `https://api.prod.goaugment.com/v2/loads/tracking`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/goaugment/apis/augment-api/docs/v2/loads/tracking/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- TrackingEventRequest
  - `loadNumber` string, required
  - `trackingEvent` TrackingEvent, required
    - `nextSequence` integer: Sequence number of the stop `nextEtaUtc` applies to, matching `LoadRouteStop.sequence`.
    - `nextEtaUtc` string, date-time: Next estimated arrival time as a UTC ISO 8601 timestamp with an offset (e.g. ending in `Z`, as in `2026-09-12T08:01:05Z`). When `isLocalTime` is true, send a naive local timestamp with no offset instead (e.g. `2026-09-12T03:01:05`).
    - `eventType` 'DELAYED' | 'INFO' | 'PICKED_UP' | 'PING' | 'COVERED' | 'DISPATCHED', required: Type of tracking event.
    - `eventSource` '4KITES' | 'CARRIER_API' | 'HIGHWAY' | 'MACROPOINT' | 'P44' | 'PHONE_EMAIL' | 'SMC3' | 'TEXT' | 'TMS' | 'TRUCKER_TOOLS' | 'OTHER', required: How the tracking data was obtained.
    - `eventUtc` string, date-time, required: Event time as a UTC ISO 8601 timestamp with an offset (e.g. ending in `Z`, as in `2026-09-11T23:00:25Z`). When `isLocalTime` is true, send a naive local timestamp with no offset instead (e.g. `2026-09-11T18:00:25`).
    - `isLocalTime` boolean: When true, `eventUtc` and `nextEtaUtc` (if present) are treated as naive local times and converted to UTC using the timezone resolved from `latitude`/`longitude`, `postalCode`, or `city`/`stateOrProvince` (in that priority order); `country` (defaults to `US`) helps disambiguate the `postalCode` lookup. One of `latitude`/`longitude`, `postalCode`, or `city`/`stateOrProvince` must be present when `isLocalTime` is true.
    - `city` string: City closest to the event location.
    - `country` string: Country of the event location, as an ISO 3166-1 alpha-2 code. Used to disambiguate the `postalCode` lookup when `isLocalTime` is true; defaults to `US` when omitted. Only `US`, `CA`, and `MX` are currently supported for this lookup — any other value falls back to `US`.
    - `stateOrProvince` string: State or province closest to the event location.
    - `postalCode` string
    - `latitude` number
    - `longitude` number
    - `temperatureF` number: Temperature in Fahrenheit, if reported by the source.
    - `notes` string: Free-text context from the carrier communication.
    - `dispatcher` TrackingEventContact: Contact information for a person associated with a tracking event.
      - `id` string: Identifier of the contact in the TMS system.
      - `name` string: Full name of the contact.
      - `phone` string: Phone number in E.164 format (e.g., +12081234567) or common local format. Supports US, CA, MX, PH.
      - `phoneExtension` string: Phone number extension (numeric only).
      - `email` string: Email address of the contact.
    - `driver` TrackingEventContact: Contact information for a person associated with a tracking event.
      - `id` string: Identifier of the contact in the TMS system.
      - `name` string: Full name of the contact.
      - `phone` string: Phone number in E.164 format (e.g., +12081234567) or common local format. Supports US, CA, MX, PH.
      - `phoneExtension` string: Phone number extension (numeric only).
      - `email` string: Email address of the contact.

## Response `204`

Load updated successfully

## Other responses

- `400`: Bad request (work in progress)

---

[API](https://skmtc.dev/goaugment/apis/augment-api.md) - [All operations](https://skmtc.dev/goaugment/apis/augment-api/llms.txt) - [OpenAPI document](https://skmtc.dev/goaugment/apis/augment-api/revisions/b61097634d79?raw)