Accessing the API with Postman


This tutorial assumes you have an app created, registered, and approved for our API. You also need a TechPulse account with a minimum role of Report Admin


Get Postman:


Launch Postman (You can skip signing in and just use the App on your local machine)


Create a basic request:



Now name your request something and create a “collection” to put it in. Null


An API can be thought of as a collection of routes or endpoints that return data to your code/tool based on parameters you send to it.


For this example we are going to use our Analytics API and the endpoint we will use is:




You can find all of the available endpoints here in our docs:


You can even expand the endpoint there to see how to use it:




Next lets go back to Postman.

Change the HTTP Request Type to POST



Now enter the following string into the url field:


This string is the domain of the US API,, combined with the address of the endpoint we talked about earlier, /analytics/v1/reports/hwinv/details/type/grid. The https:// means we are using the encrypted https protocol so all communications are completely encrypted.


Now press “send” and lets see what happens:


![create a basic reqquest](


Nothing is working because the API doesn’t know who we are.


We need to add details that will allow us to authenticate with the API.


Click Headers

Add a Key of "Content-Type" and Value of "application/json"

Click Authorization


Then oauth2 Null


Get new access token Null



Now we need to fill out all these details Null


The important fields that may not match what you see here are:

Callback URL
Client ID
Client Secret

You will need to populate these from what you have in

I suggest using a callback url of


To get the clientid and secret go to -> my apps -> click on your approved app to see its details



Now copy and paste the rest of the parameters you need from here:

Token Name                   code
Grant Type                   Authorization Code
Callback URL                 {Insert what you have from}
Auth URL           
Access Token URL   
Client ID                    {Insert what you have from}
Client Secret                {Insert what you have from}
Scope                        Read
State                        RANDOMSTRING
Client Authentication        Send as Basic Auth header


Now click on Request Token



Sign in with the same account you use for



Once successfully authed you will see this screen. Then click Use Token:



Now reclick send and let’s see what we get:


And That is all! You have successfully called our API!