Skip to main content

How to Connect Samsara

Create an API key in Samsara, copy it, paste it into Easy Truck Shop, then pick the companies (fleets) whose trucks should sync.

Written by Vladimir

How to connect Samsara, in short:

1. In Samsara, create an API key and copy it.

2. In Easy Truck Shop, go to Settings → Integrations → Samsara → + Add Connection and paste the key.

3. Pick the companies (fleets) to sync and click Save.

Step 1: Create an API key in Samsara

Do this in Samsara. You need to be a Samsara admin.

  1. Log in to Samsara and click the Settings gear at the bottom left.

  2. Scroll the left menu down to Developer and click API Tokens.

  3. Click + Add an API Token.

In the picture below: 1 = Settings gear. 2 = API Tokens. 3 = Add an API Token.

Samsara API Tokens page with the Settings gear at the bottom left, API Tokens under Developer in the left menu, and the Add an API Token button at the top right
  1. In Name, type Easy Truck Shop (1).

Samsara Add API Token window with Easy Truck Shop typed in the Name box
  1. Under Scopes, Samsara already ticks the Read scopes for you. Leave them as they are.

  2. Scroll down to Setup & Administration, open it (1) and tick Write Webhooks (2). It now says 7 Read, 1 Write Selected.

  3. Scroll to the bottom and click Save.

Setup and Administration scopes in Samsara showing 7 Read, 1 Write Selected with Write Webhooks ticked

Don't skip Write Webhooks. Without it the key still saves, but the connection won't work.

Step 2: Copy the API key

Click Copy To Clipboard (1). Samsara shows the key only once, so paste it into Easy Truck Shop right away. If you lose it, create a new one.

New Easy Truck Shop API token in Samsara with the Copy To Clipboard button

Step 3: Paste the key in Easy Truck Shop

  1. In Easy Truck Shop, click your name at the top right.

  2. Click Settings.

  3. Click the Integrations tab.

  4. Click Samsara on the left.

  5. Click + Add Connection.

The numbers in the picture match the steps: 1 = your name. 2 = Settings. 3 = the Integrations tab. 4 = Samsara. 5 = + Add Connection.

Where to connect Samsara in Easy Truck Shop: 1 your name at the top right, 2 Settings, 3 the Integrations tab, 4 Samsara in the left menu, 5 the + Add Connection button

Then fill in the new connection:

  1. In Name, type a name you'll recognize, for example your fleet name (1).

  2. In API Key, paste the key you copied (2).

  3. Click Save (3).

New Samsara Connection page in Easy Truck Shop with the Name box, the API Key box and the Save button

Step 4: Pick the fleets to sync

After you save, a Companies section shows up. Only the companies you add here get their trucks synced from Samsara.

  1. Click Search customers and type the company name (1).

  2. Click the company in the list (2).

  3. Click + Add (3).

Companies section of the Samsara connection with the Search customers box, the company list and the Add button
  1. The company now shows in the list with its number of units (1). Add more companies the same way.

  2. Click Save (2).

Samsara connection with one company added under Companies showing its MC number and units, and the Save button

More than one shop in Easy Truck Shop? Do Steps 3 and 4 in each shop. You can paste the same API key.

Check that it worked

Go to Customers, open the company and stay on the Vehicles tab. The Samsara column (1) shows the Samsara unit for each matched truck. Odometer readings now sync by themselves.

Customer Vehicles tab in Easy Truck Shop with the Samsara column showing the Samsara unit for each truck

Don't see a Samsara column? Turn it on: click the columns icon at the right end of the table header and tick Samsara. In the picture below: 1 = Customers. 2 = the Vehicles tab. 3 = the columns icon. 4 = the Samsara box to tick. 5 = the Samsara column.

How to turn on the Samsara column: 1 Customers at the top, 2 the Vehicles tab on the company page, 3 the columns icon at the right of the table header, 4 the Samsara box ticked in the Columns list, 5 the Samsara column showing the Samsara unit for each truck.

Once you see the Samsara unit in the column, the truck is connected. The mileage takes time to update after you connect, usually 10 to 15 minutes.

If a truck's Samsara column is empty, that truck was not matched to a Samsara vehicle. Make sure the VIN is correct and the same in both Samsara and Easy Truck Shop. For the full checklist, see Why isn't my truck's mileage updating from Samsara?

Related questions

  • How do I connect Samsara to Easy Truck Shop?

  • Where do I get the Samsara API key?

  • Which scopes does the Samsara API token need?

  • I connected Samsara but no trucks are syncing. What did I miss?

  • How do I choose which fleets or companies sync from Samsara?

  • I have more than one shop. Do I connect Samsara in each one?

  • Where do I see the Samsara unit on a truck?

  • How do I sync odometer readings from Samsara?

Related articles

Did this answer your question?