API collections are sets of queries already created by Insightful so that data from our application could be communicated and transferred more easily and quickly. These collections are structured to provide you with a better insight into the data that you can use.
The easiest way to get API collections is by clicking on Run in Postman button in the upper right corner of our API documentation page.
This will open your Postman app (or ask you to download and install if you don't have it on your computer already) and automatically import all Insightful API requests collections.
To use our API, you need to have an active Insightful account.
To complete this process you will need to follow a few steps:
Getting Bearer token for Authorization
Login as an Admin to your organization's account on https://app.insightful.io.
Go to Settings → API Tokens
Click on Create new Token button.
Create new API token window will appear. Assign a name to your Token first.
After naming the token, button to generate will become active. Click on it to get your new token. Kindly note that this is the only time this specific token will be shown.
Once the token is generated, copy the token and make sure you are storing it safely.
Applying Authorization to the desired collection
Click on three dots on the root collection folder you wish to be authorized to access and use.
Click on Edit
On Edit Collection window, select Authorization tab, make sure Type is Bearer Token and paste the token you received last. Click on Update.
You can have API token with READ and API token with WRITE sets of permissions.