Get an integration link

To connect providers, you will need to obtain a connection link. To obtain a connection link, call the /tenant endpoint.

import requests

url = "https://api.pathstack.io/tenant"
headers = {"Authorization": "Bearer <access-token>"}

response = requests.request("GET", url, headers=headers)

connection_url = response.json()["data"]["connection_url"]
# example: https://portal.dev.pathstack.io/connect?code=83pbN8feZDK8F4L3rJH2fX-EsJS0MDEDKE0

Replace <access-token> with an access token. You can find out how to get an access token here.

This connection link is used to integrate with our partnered telematics providers. See a full list of supported providers here.

This link is used to connect your telematics accounts to PathStack. You can do this yourself, or send this link to your clients. To connect an integration, select the telematics company in the list.


Connect your integration to PathStack

Now that you (or your client) have selected the integration, enter the details for the connection.

The fields for Business Name and ABN are for identifying the telematics connection. The other fields are specific to each integration. In this example, you would need to provide the Verizon Connect App ID, and the username and password for accessing the API.

All credentials are securely stored in PathStack once a telematics integration has been connected.

You're connected!

Once you submit the form, PathStack will connect to the telematics provider you have selected and start pulling data in to PathStack. You can find the new connection by calling the /connection endpoint.

import requests

url = "https://api.pathstack.io/connection"

querystring = {"telematics_provider":"verizon_connect"}

headers = {"Authorization": "Bearer <access-token>"}

response = requests.request("GET", url, headers=headers, params=querystring)


This will return a response that looks something like this:

  "data": [
      "integration_name": "verizon_connect",
      "business_name": "Bob's Trucking",
      "abn": "123456789",
      "email": "owner@bobstrucking.com.au",
      "active": true,
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenant_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"

Now that you have a connection, you can start requesting data!

It can take up to 30 minutes for data to flow from the telematics provider to PathStack