Truv offers a Postman collection for a no-code way to get started with the Truv. Follow the step-by-step guide below:
Set up Postman
- Install Postman.
- Add the Postman collection.
- Select the environment from the dropdown in the upper right corner.
- Add your Client ID and Access secret for the selected environment:
- Click the Environment Quick Look item in the upper right corner.
- Click Edit for the specific environment.
- Add or modify the client_id and access_key variables. The values for your credentials are found in your Truv Dashboard.
- Click Save in the upper right corner.
Make API Requests
- Open Postman's Collections section on the left side of the window.
- Expand the Public Truv API item.
- Set your credentials in the header:
- Click the Authorization tab.
- Type should be set to API Key.
- Other settings can be ignored
- Click the Pre-request Script tab.
- Script should be set to the following:
pm.request.headers.add({ key: "X-Access-Client-Id", value: pm.variables.get("client_id") }); pm.request.headers.add({ key: "X-Access-Secret", value: pm.variables.get("access_key") });
- Set the value for X-Access-Client-Id to your Client ID, in double quotes, found in your Truv Dashboard.
- If the user already established client_id as an environment variable, then the user should set the value field to pm.variables.get("client_id"). Set by default.
- Set the value for X-Access-Secret to your Access key, in double quotes, found in your Truv Dashboard.
- If the user already established access_key as an environment variable, then the user should set the value field to pm.variables.get("access_key"). Set by default.
- Expand bridge-tokens and select the Create Bridge Token endpoint.
- Prepare the request:
- Click on the Headers tab.
- Uncheck the Content-Type row.
- Click on the Body tab.
- Choose form-data below.
- Add a product_type key.
- Set the value of product_type to the product you want to use (e.g., "income", "employment", etc.)
- Refer to Create Bridge Token.
- Click the Send button.
When the request is complete you can review the response returned by Truv in the Response section below the Request section.