Skip to main content

Samsara

Overview​

The Samsara source connector lets you connect to the Samsara API using an API token.

At this time, the connector can validate credentials, but data extraction is still in development (runs will fail during extraction).

Setup​

Prerequisites​

  • A Samsara account with access to generate an API token.
  • Network access to the Samsara API endpoint for your region.

Create an API token in Samsara​

  1. In Samsara, generate an API token (bearer token).
  2. Copy the token and store it securely.

Authentication​

This connector uses Bearer token authentication.

  • The token is sent as:
    • Authorization: Bearer <api_token>

Configuration​

FieldTypeRequiredDescription
api_tokenstring✅Samsara API token used for authentication.
regionstring✅API region to use. Use eu for the EU API; any other value uses the default (US) API.

Region behavior​

  • If region is set to eu, the connector uses: https://api.eu.samsara.com
  • Otherwise, it uses: https://api.samsara.com

Connectivity check (credential validation)​

On connection test / login, the connector validates credentials by calling:

  • GET /fleet/vehicles?limit=1

If the request fails, the connector reports: “Samsara credential validation failed”.

Streams​

No streams are currently available. The connector’s catalog is empty, and extraction is not yet implemented.

Limitations​

  • Extraction is not available yet: connector runs will fail with an error indicating extraction is still in development.
  • No incremental sync behavior is available yet (no streams).