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

# Connecting Samsara to Neo

> Create a Samsara API token and save it in Neo

You connect Samsara once at the MSP level, with an API token.

## 1. Create an API token in Samsara

<Steps>
  <Step title="Open API Tokens">
    Sign in to the Samsara dashboard as an admin, open **Settings** (the gear icon), and scroll to **API Tokens**. Click **Add an API Token** and name it "Neo".
  </Step>

  <Step title="Choose tag access">
    Give the token access to every tag your technicians' vehicles carry, or to all tags. Neo cannot see a vehicle outside the token's tags.
  </Step>

  <Step title="Choose the scopes">
    For onsite time and vehicle tracking, give the token at least **Read Vehicles** and **Read Vehicle Statistics** (Vehicles), **Read Trips** (Trips), **Read Drivers** (Drivers), **Read Assignments** (Assignments), **Read Addresses** (Addresses) and **Read Org Information** (Setup & Administration). Add a write scope only for what you want agents to change, such as **Write Addresses** to add client sites. Neo also checks the permission groups you set per agent, so a scope alone never lets an agent change something.
  </Step>

  <Step title="Copy the token">
    Samsara shows the token once. Copy it.
  </Step>
</Steps>

## 2. Add the token in Neo

<Steps>
  <Step title="Open Integrations">
    Open [**Integrations → Samsara**](https://dashboard.neoagent.io/integrations?tab=directory\&open=samsara) in the Neo Dashboard. The card is under Other.
  </Step>

  <Step title="Save the token">
    Pick your **Region**: **United States** if you sign in at cloud.samsara.com, **Europe and UK** if you sign in at cloud.eu.samsara.com, **Canada** if you sign in at cloud.ca.samsara.com. Paste the **API Token** and click **Save**. Neo checks the token with Samsara before it saves, so a wrong token or region is rejected straight away.
  </Step>
</Steps>

## 3. Turn Samsara on per agent

Open the agent from [**Agents**](https://dashboard.neoagent.io/agents), go to the Integrations section, and configure the Samsara block. Pick a profile, then change any group. For onsite time, **Vehicles, Locations & Trips**, **Drivers & Assignments** and **Addresses, Routes & Dispatch** at Read Only are enough; the time itself is written through your PSA tools.

### Changes that always ask a technician

Whatever the profile: immobilizing, locking or unlocking a vehicle, setting an equipment or industrial output, deactivating a gateway, setting a driver's duty status, creating or changing a live sharing link, every change to Samsara users, webhooks, Functions and their stored files, and data sharing, any change that sends a password, secret or token, and any change that records an approval decision in Samsara, such as approving an estimate, a purchase order or a form submission.

See [Samsara API](/agents/tools/management/samsara-api) for what each profile does.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.