Skip to main content

​
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.
Samsara operates different portals for different regions. Terminal supports North America (cloud.samsara.com) and Europe (cloud.eu.samsara.com). If you have customers in both regions, you will need to complete the steps below for each region. Make sure to use a unique email address for each region because the same email cannot be used for multiple regions.

​
Creating a Developer Account

You can skip this step if you already have a Samsara developer account in the relevant region
  1. Submit Samsara’s partner application form.
  2. Accept the invite Samsara sends you to create a developer account. This may take up to 7 business days.
    • If you don’t receive an invite after 7 business days, reach out to support@withterminal.com.
  3. Invite support@withterminal.com to your Samsara organization.

​
Creating an OAuth Application

If you support multiple regions, repeat these steps in each regional portal
To create an OAuth application with Samsara, follow these steps:
  1. Create a new application:
    • Log in to your Samsara dashboard (North America Link | EU link) and go to the Apps tab
    • Click Create new app
    • Enter the required details (name, tag line, logo, etc.)
  2. Under Redirect URLs, add:
  1. 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.
  1. Click Save to create your application.
  2. Click on the application you just created.
  3. In the top right, change the app state to Beta. Learn more about app states here.
  4. Click Save to make your application available for customer use.
  5. Invite support@withterminal.com to your Samsara organization.

​
Update Samsara Configuration in the Terminal Dashboard

You will need your Production Terminal app provisioned before you can complete this step. If necessary, return here when that occurs.You must be a Terminal Dashboard admin to perform this step.
  1. Go to the Terminal Dashboard Settings
  2. Scroll down to Samsara
  3. Paste the Client ID and Client Secret from Samsara into the Terminal dashboard.
    • If you created applications in multiple regions, paste the credentials for each region under its respective section
  4. Click Save Changes to save the configuration.
  5. Begin connecting Samsara fleets to Terminal 🚛

​
Connecting Samsara Fleets

The user authorizing the connection on the fleet’s Samsara account must have a Full Admin or Standard Admin role. Samsara blocks OAuth installs for users without one of these roles, and the error is surfaced on Samsara’s side before the flow returns to Terminal.

​
Publishing Your Application

Once your integration is in production and at least one Samsara fleet has connected to your application, follow Samsara’s App Certification Process to submit it for inclusion in the Samsara App Marketplace.
Until your app is certified, fleets will see a banner during OAuth that says: “This application has not been formally certified by Samsara.” This will not affect anyone’s ability to connect through Samsara and it’s okay for your app to remain in this state indefinitely.
If you support multiple regions, complete certification separately in each regional portal (North America and Europe).