Samsara Developer Portal

Integrate your data with the Samsara API, customize the Samsara experience, and join a community of developers building with Samsara.

Get Started

Getting Started with Samsara

Samsara provides a robust set of REST APIs to allow you to integrate Samsara into virtually any platform. These APIs cover all of Samsara's major product areas, including core fleet, asset, safety, and industrial management.

Authentication

To make any calls to Samsara, you will need an API token. You can create this token on the Settings page of the Samsara Dashboard. Click the gear icon on the top left of your Samsara Dashboard, and scroll down to "API Tokens":

Samsara Dashboard -> Settings -> API Tokens

Samsara Dashboard -> Settings -> API Tokens

Click "Add an API Token". If you do not need to manipulate data in Samsara, it is best to create a "Read-Only" access token.

Samsara uses the Bearer Token HTTP authentication scheme. Include the authentication token in the Authorization header in your HTTP request:

Authorization: Bearer {access_token}

Your first API call

Let's make our first call to the Samsara REST API!

# Copy the cURL request below into your Terminal.
# Replace **{access_token}** with your Access Token.
# Run the query to see a response with all your drivers listed.

curl --request GET \
  --url https://api.samsara.com/fleet/drivers \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access_token}'

You will receive a JSON response of all the drivers in your organization.

Test the APIs

We've created a Postman collection of our APIs so that you can test them out easily. Postman is a point-and-click desktop app for running REST APIs.

You can find the Postman collection in Samsara's github repository.

  1. Download the Postman app.
  2. In the Postman app, import the collection by pasting the following link into the Import dialog box:
https://raw.githubusercontent.com/samsarahq/api-docs/master/Samsara%20API.postman_collection.json
  1. The collection will auto-populate on the left-hand panel with folders containing all of Samsara's APIs.
  1. The collection is set up to accept your API access token as a variable, so that you don't need to configure each call with your access token. Click on the three dots next to the collection and then click "Edit" to enter your API access token.
  1. Paste your API access token into the token variable. Click "Reset All" to update the variable with the value you pasted. Then click "Update".
  1. You can submit an API by selecting it, filling out its parameters, and clicking "Send".

Updated about a month ago



Getting Started with Samsara


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.