---
title: "Transit Update"
method: POST
path: "/TRACKING_UPDATE"
tags: ["Track & Trace"]
---

# Transit Update

`POST /TRACKING_UPDATE`

## Request

- Base URL: `https://apidocs.goaugment.com` (the document declares no server; this is the origin it was published from)
- URL: `https://apidocs.goaugment.com/TRACKING_UPDATE`
- Auth: none declared
- TypeScript: <https://skmtc.dev/goaugment/apis/webhooks/docs/TRACKING_UPDATE/post.ts> (a function with typed inputs; its response is checked against the schema)

> v1 equivalent: `trackingEvent` (flat payload).

Sent when Augment receives a location or tracking update from a carrier communication. Contains the driver's current position, the next stop ETA, and the source of the tracking data.

## Request body

- TransitUpdateEvent: Fields present on every v2 webhook event.
  - `id` string, required: Unique event identifier (ULID)
  - `workflow` 'TRACK_AND_TRACE' | 'CARRIER_SUPPORT' | 'POD_COLLECTION' | 'LOAD_BUILDING' | 'CARRIER_SELECTION' | 'SCHEDULING' | 'CUSTOMER_SUPPORT' | 'null', nullable, required: The Augment workflow that produced this event, or `null` when no single workflow can be attributed. New values may be added over time, so treat this as an open set rather than a fixed list.
  - `occurredAt` string, date-time, required: When the underlying activity occurred (ISO 8601)
  - `loadNumber` string, nullable, required: Your load reference number
  - `customerLoadInternalId` string, nullable, required: Your internal load ID, if provided during load creation
  - `eventType` 'TRACKING_UPDATE', required: Event name for a transit update.
  - `data` TrackingEvent, required: A location or tracking update derived from carrier communication.
    - `eventType` 'DELAYED' | 'INFO' | 'PICKED_UP' | 'PING' | 'DRIVER_AT_PICKUP' | 'DRIVER_AT_DELIVERY' | 'DELIVERED' | 'COVERED' | 'DISPATCHED', required: Type of tracking event
    - `eventCode` 'AA' | 'AB' | 'AF' | 'AG' | 'AM' | 'AR' | 'B1' | 'CD' | 'D1' | 'J1' | 'NS' | 'OA' | 'X1' | 'X3' | 'X4' | 'X6': Optional EDI 214 tracking status code.
    - `eventSource` '4KITES' | 'CARRIER_API' | 'HIGHWAY' | 'MACROPOINT' | 'P44' | 'SMC3' | 'TRUCKER_TOOLS' | 'PHONE_EMAIL' | 'PHONE' | 'EMAIL' | 'TEXT' | 'TMS' | 'OTHER', required: How the tracking data was obtained
    - `eventUtc` string, date-time, required: Event time as a UTC ISO 8601 timestamp ending in `Z`.
    - `eventLocalTime` string, date-time: Event time as a UTC ISO 8601 timestamp ending in `Z`.
    - `nextSequence` integer: Next stop sequence number
    - `nextEtaUtc` string, date-time: Next estimated arrival time as a UTC ISO 8601 timestamp ending in `Z`.
    - `city` string
    - `country` string
    - `stateOrProvince` string
    - `postalCode` string
    - `latitude` number
    - `longitude` number
    - `temperatureF` number: Temperature in Fahrenheit (if available)
    - `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 `200`

Event acknowledged

---

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