Help Center / ELD Connections

Connect Samsara

Paste a Samsara API token to bring truck GPS locations into CloudTMS and, if you choose, dash cam safety events. Remaining HOS hours sync only for drivers linked by Samsara driver ID, which CloudTMS can't set yet.

Where in CloudTMS: /settings/integrations, /dispatch

Before You Connect

Create an API token in your Samsara admin console with the vehicles:read and drivers:read scopes. Add cameras:read if you also want dash cam data.

CloudTMS matches trucks by name: each truck's Unit number in CloudTMS has to match the vehicle's name in Samsara (capitalization doesn't matter). A driver's location is taken from the truck they're assigned to in CloudTMS.

Connect Samsara

  1. Open Settings, then Integrations, and find the Samsara card under ELD / Hours of Service. (page: /settings/integrations)
  2. Paste your token into API token. (page: /settings/integrations)
  3. Under What should this connection deliver?, keep ELD (HOS + locations) ticked. Tick Also enable camera data (dash cams, safety events) if your token and Samsara account include cameras. (page: /settings/integrations)
  4. Click Connect Samsara. CloudTMS tests the token first and shows an error if Samsara rejects it. (page: /settings/integrations)
  5. To pull data right away, click Sync now. The confirmation tells you how many drivers and vehicles were updated. (page: /settings/integrations)

What Comes In

Truck GPS locations, shown for drivers on the dispatch map. CloudTMS pulls new data automatically every few minutes. The card says every 15 minutes, but it runs more often than that.

Remaining HOS hours: one number per driver (drive time left, or shift or cycle time left when drive time isn't reported). This only updates for drivers linked to their Samsara driver ID, and there's no field in CloudTMS to set that link yet, so expect locations to flow and HOS hours to stay empty. Contact support if you need HOS matched.

Safety events (if cameras are on): the card shows a weekly count. Events show up under Safety Events on a driver's Performance tab only when they're matched to that driver, and that uses the same driver ID link.

Change or Disconnect

On the connected card, use the checkboxes under This connection provides to switch ELD (HOS + locations) or Cameras & safety events on or off. Click Disconnect to remove the token.

Only one provider can be your ELD source for each MC. If Motive or Geotab already holds that role, disconnect it before connecting Samsara. If you run more than one MC, connect each MC separately.

If a sync fails, the card shows the Last error from Samsara.

Related Articles

Didn't find what you needed?

Send us a support request — if you're signed in, we can look up the load, settlement or invoice you're asking about. Or email support@cloudtms.io.