Samsara OAuth Configuration

Overview

This guide provides detailed instructions on integrating Samsara with your Terminal instance.

This is required for Samsara specifically in order to guarantee:

The OAuth flow is consistent with your branding.
The permissions are customized for your specific needs.
You can publish your application in the Samsara marketplace.

Creating a Developer Account

You can skip this step if you already have a Samsara developer account

Submit Samsara’s partner application form.
Sign Samsara’s Mutual Non-Disclosure Agreement (MNDA)
- Use daniel.reynolds@samsara.com as the Samsara contact email.
Accept the invite Samsara sends you to create a developer account.
Invite support@withterminal.com to your Samsara organization.

Creating an OAuth Application

To create an OAuth application with Samsara, follow these steps:

Create a new application:
- Log in to your Samsara dashboard and go to the Apps tab
- Click Create new app
- Enter the required details (name, tag line, logo, etc.)
Under Redirect URLs, add:

https://link.withterminal.com/oauth/callback/samsara

Choose the necessary Scopes for your application.

Below is a summary of the scopes you might need from Samsara, depending on the Terminal common models you intend to utilize.

It’s best to request all the permissions you might need upfront. Adding permissions later will require customers to re-authenticate, which can be avoided with early planning.

Common Model	Samsara Scope
General (required)	`Setup & Administration > Read Org Information` `Setup & Administration > Read Webhooks` `Setup & Administration > Write Webhooks`
Vehicles (required)	`Vehicles > Read Vehicles`
Groups	`Setup & Administration > Read Tags`
Devices	`Setup & Administration > Read Gateways`
Drivers	`Drivers > Read Drivers`
Vehicle Locations Vehicle Stat Logs	`Vehicles > Read Vehicle Statistics` `Assignments > Read Assignments`
Trips	`Vehicles > Read Vehicle Trips`
Trailers	`Trailers > Read Trailers` `Equipment > Read Equipment`
Trailer Locations	`Trailers > Read Trailer Statistics` `Equipment > Read Equipment Statistics`
HOS Logs HOS Daily Logs HOS Available Time	`Compliance > Read ELD Hours of Service` `Compliance > Read ELD Compliance Settings`
Safety Events	`Safety & Compliance > Read Safety Events & Scores` `Safety & Cameras > Read Camera Media` (optional)
IFTA Summaries	`Compliance > Read IFTA (US)`
Passthrough	Select any other scopes you plan to leverage if using passthrough

Click Save to create your application.
Click on the application you just created.
In the top right, change the app state to Beta. Learn more about app states here.
Click Save to make your application available for customer use.
Invite support@withterminal.com to your Samsara organization.

Update Samsara Configuration in the Terminal Dashboard

You must be a Terminal Dashboard admin to perform this step.

Go to the Terminal Dashboard Settings
Scroll down to Samsara
Paste the Client ID and Client Secret from Samsara into the Terminal dashboard.
Click Save Changes to save the configuration.
Begin connecting Samsara fleets to Terminal 🚛

Publishing Your Application

Once your integration is in production and Samsara fleets have connected to your application, you can request that Samsara review your application for inclusion in their marketplace.

Welcome

Introduction

Terminal API Basics

Terminal Platform

Configuration

Samsara OAuth Configuration

Overview

Creating a Developer Account

Creating an OAuth Application

Update Samsara Configuration in the Terminal Dashboard

Publishing Your Application

Welcome

Introduction

Terminal API Basics

Terminal Platform

Configuration

​Overview

​Creating a Developer Account

​Creating an OAuth Application

​Update Samsara Configuration in the Terminal Dashboard

​Publishing Your Application

Overview

Creating a Developer Account

Creating an OAuth Application

Update Samsara Configuration in the Terminal Dashboard

Publishing Your Application