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

# Getting Started

> Here's a step-by-step guide to get started integrating telematics data with Terminal.

<Info>
  **Prerequisites** You must have a valid sandbox secret and publishable key to
  follow this guide. Existing Terminal customers can get their sandbox keys from
  the [Sandbox Dashboard](https://dashboard.sandbox.withterminal.com/api-keys).
  If you don't have access yet, reach out to us at [connect@withterminal.com](mailto:connect@withterminal.com).
</Info>

## Video Walkthrough 🎥

Here's a quick video walkthrough of the steps below:

<div
  style={{
position: 'relative',
paddingBottom: '64.90384615384616%',
height: '0',
}}
>
  <iframe
    src="https://www.loom.com/embed/c8f94e90f97146a58b94401c2838166c?sid=d2e528a8-2fd3-4364-b759-13576fa3baf2"
    frameBorder="0"
    allowFullScreen
    style={{
  position: 'absolute',
  top: '0',
  left: '0',
  width: '100%',
  height: '100%',
}}
  />
</div>

## Instructions ✔️

1. Download our [Postman collection](https://github.com/terminal-api/postman) and import it into Postman

2. Launch the Link to create a new connection

   * Replace `{PUBLISHABLE_KEY}` and navigate to the Link URL

   ```
   https://link.sandbox.withterminal.com/?key={PUBLISHABLE_KEY}&backfill_days=2&redirect_url=https%3A%2F%2Fpostman-echo.com%2Fget
   ```

3. Select the Sandbox provider

4. Enter any value as an API Key to create a connection

5. Wait to be re-directed to the `redirect_url` with a `token` appended to the URL

6. Take the public `token` appended to the redirected page and copy it to your clipboard

7. Exchange public token for a long-lived connection token
   * Call [`POST /public-token/exchange`](/api-reference/authentication/public-token-exchange)

8. Poll until the initial sync is complete
   * Call [`GET /connections/current`](/api-reference/connections/get-current-connection)

<Tip>
  You can also subscribe to `sync.completed` webhooks
  ([docs](/terminal-platform/webhooks)) to know when syncs are complete.
</Tip>

7. List synced vehicles
   * Call [`GET /vehicles`](/api-reference/vehicles/list-vehicles)
8. Explore the rest 🚀

## Possible Next Steps

* [Learn best practices for syncing data at scale →](/guides/syncing-data)
* [Explore more endpoints using the HTTP console built in to our docs →](/api-reference)
* [Learn more about the Link and it's available options →](/link-component)
