CarrierGuide integrates with Samsara to monitor your fleet, sync drivers’ Hours of Service (HOS), and support load document upload. Samsara mileage is also used to build your IFTA report in CarrierGuide. Follow the steps below to connect your account, then check the matching rules for trucks, drivers, and documents so your data syncs correctly.

This article will cover:

• Connect to Samsara
• Truck sync
• Driver’s Hours of Service (HOS)
• Load document upload

Connect to Samsara

1. Log in to cloud.samsara.com.
2. Click the settings icon in the lower left corner.
3. Go to Developer and click API Tokens.
4. Click + Add an API Token.
   
5. In the Name field, enter “Kamion”.
   
   
6. Under Scopes > Global, select Global Read.
   
   
7. If you use the IFTA report, also select Read IFTA (US) under Compliance.
8. Click Save and copy the generated API token.
9. In your CarrierGuide account, go to Settings > Integrations > ELDs.
10. On the Samsara integration card, click Install > Next.
    
11. Paste the API token from Samsara and click Connect to install the integration.
    

Truck sync
The CarrierGuide and Samsara integration syncs the following truck data:

• Truck position for load tracking
• Odometer mileage
• Engine state (on/off)
• Speed (MPH)

Samsara mileage is also used for the IFTA report.

To make sure a truck connects, the vehicle Name in Samsara must exactly match the Truck Number in the truck profile in CarrierGuide, including capitalization. VIN and registration number are not used.

Driver’s Hours of Service (HOS)
To sync a driver’s HOS, the phone number in the driver’s CarrierGuide profile must be the same as the one in Samsara. Write it exactly the same way in both systems (for example, +15551234567 in both). Different formatting won’t match.

Load document upload
CarrierGuide checks the Samsara integration every 15 minutes for load documents. It only searches for documents uploaded within the past 24 hours. The document template in Samsara must have:

1. At least one field of type Photos.
   
2. A field of type Number whose name contains the words “Load Number”. This field must contain exactly the CarrierGuide load number. Only numeric load numbers can match.
   
3. A document name that matches the document type in CarrierGuide (see the mapping below).

Document type mapping
The Document Type name in Samsara must match exactly, including capitalization:

• Bill of Lading
• Proof of Delivery
• Scale Ticket
• Proof of Delivery Lumper
• Load Pictures
• Receipts
• Citation

FAQ
Do I need the Read IFTA (US) scope?
Only if you use the IFTA report. Samsara mileage feeds that report, so select Read IFTA (US) under Compliance when you create the token.

My truck isn’t syncing. What should I check?
Make sure the vehicle Name in Samsara exactly matches the Truck Number in CarrierGuide, including capitalization. VIN and registration number aren’t used for matching.

A driver’s HOS isn’t showing. Why?
The phone number must be written exactly the same in the driver’s CarrierGuide profile and in Samsara, for example +15551234567. Different formatting won’t match.

Why wasn’t my document uploaded to the load?
Check that the Load Number field contains exactly the CarrierGuide load number (numeric only), that the template has at least one Photos field, and that the document name matches a type in the mapping above. Only documents uploaded in the last 24 hours are picked up, and checks run every 15 minutes.