API clients

Choose the collection supported by your API client. The Postman and Bruno downloads contain every request in the seventhings Customer API, organised by API area and generated from the current release. Insomnia imports the Postman collection.

Postman

Download the Postman collection

1. In Postman, select Import and choose the downloaded JSON file.

2. Open the imported seventhings Customer API collection.

3. In the collection’s Variables tab, set instanceHost to your seventhings instance hostname without https:// or a trailing slash. For example:

   your-instance.seventhings.com

4. Open Auth → Obtain an access token, enter your client ID, username, and password, then send the request.

The response script stores a successful access token in bearerToken for all subsequent requests.

You can also import the collection directly from:

https://api.seventhings.com/customer-api.postman_collection.json

Insomnia

Insomnia supports Postman collections, so it uses the same JSON download:

Download the Postman collection for Insomnia

1. In an Insomnia project, select Import → File and choose the downloaded JSON file.

2. Select Scan, then import the detected collection.

3. Open the collection’s Base Environment and set instanceHost to your seventhings instance hostname without https:// or a trailing slash. For example:

   your-instance.seventhings.com

4. Open Auth → Obtain an access token, enter your client ID, username, and password, then send the request.

Insomnia converts the imported Postman response script and stores a successful access token in the Base Environment as bearerToken.

Bruno

Download the OpenCollection package

The ZIP contains a native OpenCollection YAML collection for Bruno 3.0 and newer. Bruno can import the ZIP directly.

1. In Bruno, select Import Collection and choose the downloaded ZIP file.

2. Select the included Your instance environment.

3. Set its baseUrl value to the complete origin for your seventhings instance, including https://. For example:

   https://your-instance.seventhings.com

4. Open Auth → Obtain an access token, enter your client ID, username, and password, then send the request.

5. Copy the access_token from the response. In the Your instance environment, paste it into the token variable.

Authenticated requests use the token variable from the selected environment. Bruno does not save the login response token automatically.

Client ID

In your seventhings instance, open Integrations → API to find your client ID.