> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vooma.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Vooma Track

> Faster issue detection, proactive tracking, and seamless escalation powered by AI

## Partnered TMS

If you use one of our partnered TMS platforms, Vooma Track will work largely out-of-the-box.

If you would like to build a new integration, you'll need to implement Shipment sync so that Vooma has an up to date record of your shipments, and write tracking status updates to keep Vooma informed of shipment locations.

## Custom Integration

<AccordionGroup>
  <Accordion title="Set up Shipment sync">
    Notify Vooma when a new shipment is [created](/api-reference/shipments/create) in your system, when a shipment's data is [updated](/api-reference/shipments/update) or [both](/api-reference/shipments/upsert)
  </Accordion>

  <Accordion title="Write to Tracking Status endpoint">
    Send tracking status updates to Vooma by writing to the [Tracking Status endpoint](/api-reference/tracking-status/create). This endpoint accepts location updates for shipments using either geocoordinates (latitude/longitude) or city/state information, along with a timestamp and optional metadata.

    The endpoint requires:

    * `movement.externalIds`: Identifies the movement using a CUSTOM external ID (same as the Movements API)
    * `timestamp`: Unix timestamp in milliseconds
    * `location`: Either geocoordinates (`latitude`/`longitude`) or city/state (`city`/`state`)
    * `metadata`: Optional additional information about the tracking status

    Vooma will use these updates to provide real-time tracking visibility and detect potential issues proactively.
  </Accordion>
</AccordionGroup>