Sandboxes

Users will need to be added separately for the Developer Portal and the Sandbox.

❗️
If there are issues with your sandbox (e.g. you can't find one, you want to test with simulated GPS data), contact Samsara Support. Include your developer portal org ID (in the cloud.samsara.com URL).

This is an equivalent environment to a Samsara customer dashboard. You can access Samsara's native features and navigate to Settings > Apps to install your draft app (i.e. grant data sharing via OAuth 2.0 or API Token) for alpha testing.

ℹ️ Sandboxes are an area we want to enhance over time to make the developer experience better. What type of simulated data would support integration development and alpha testing? Please submit your requests for improvement via our feedback form here.

How do I access test data in my sandbox?

You have two options for testing:

Contacting Samsara Support to have them generate fake GPS data for 3 vehicles. These vehicles will last for 100 days and you can request for them to be recreated if needed. We do not support other types of data points.
- Access to simulated data from these 3 vehicles is not guaranteed to be always on given sandboxes are non-production environments.
- The three GPS paths these vehicles will continuously run, so you can define test cases around the predictable paths these vehicles have. Wait a few hours to see which routes these vehicles are regularly running, which can be viewed by clicking into the vehicle from the Overview page and view their Trips. The three paths are:
  - Last Mile Delivery Route in Northern California
  - Trucking Route between Northeast US and CA
  - Passenger Bus route in London
Contacting a mutual customer to acquire an API token from their Samsara org. You can scope that token down to a Samsara Tag to limit which assets and drivers you will test your integration on.

Get API access in your Sandbox

Use your Sandbox to follow the steps a mutual customer would take to install your app (i.e. grant data sharing access). You can access your draft app in your test org for testing.

OAuth 2.0 apps: log in to Samsara and grant data access via your draft app
[Legacy] API Token apps: install your draft app under Settings > Apps to generate a prescoped API token