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.
Log in to Samsara and click the Settings gear at the bottom left.
Scroll the left menu down to Developer and click API Tokens.
Click + Add an API Token.
In the picture below: 1 = Settings gear. 2 = API Tokens. 3 = Add an API Token.
In Name, type Easy Truck Shop (1).
Under Scopes, Samsara already ticks the Read scopes for you. Leave them as they are.
Scroll down to Setup & Administration, open it (1) and tick Write Webhooks (2). It now says 7 Read, 1 Write Selected.
Scroll to the bottom and click Save.
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.
Step 3: Paste the key in Easy Truck Shop
In Easy Truck Shop, click your name at the top right.
Click Settings.
Click the Integrations tab.
Click Samsara on the left.
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.
Then fill in the new connection:
In Name, type a name you'll recognize, for example your fleet name (1).
In API Key, paste the key you copied (2).
Click Save (3).
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.
Click Search customers and type the company name (1).
Click the company in the list (2).
Click + Add (3).
The company now shows in the list with its number of units (1). Add more companies the same way.
Click Save (2).
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.
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.
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?










