Postman Collection

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

  1. Install Postman.
  2. Add the Postman collection.

Run in Postman

  1. Select the environment from the dropdown in the upper right corner.

  1. Add your Client ID and Access secret for the selected environment:
  2. Click the Environment Quick Look item in the upper right corner.
  3. Click Edit for the specific environment.
  4. Add or modify the client_id and access_key variables. The values for your credentials are found in your Truv Dashboard.
  5. Click Save in the upper right corner.

Make API Requests

  1. Open Postman's Collections section on the left side of the window.
  2. Expand the Public Truv API item.
  3. Set your credentials in the header:
    1. Click the Authorization tab.
    2. Type should be set to API Key.
    3. Other settings can be ignored
    4. Click the Pre-request Script tab.
    5. 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")
    });
    
    1. Set the value for X-Access-Client-Id to your Client ID, in double quotes, found in your Truv Dashboard.
    2. 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.
    3. Set the value for X-Access-Secret to your Access key, in double quotes, found in your Truv Dashboard.
    4. 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.
  4. Expand bridge-tokens and select the Create Bridge Token endpoint.
  5. Prepare the request:
  6. Click on the Headers tab.
  7. Uncheck the Content-Type row.
  8. Click on the Body tab.
  9. Choose form-data below.
  10. Add a product_type key.
  11. Set the value of product_type to the product you want to use (e.g., "income", "employment", etc.)
  12. Refer to Create Bridge Token.
  13. 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.