Overview

The Truv Postman Collection offers a solution for getting started with your integration with little to no code needed. View the sections below for more on setting up and using Truv with Postman.

Setting up Postman

The section below covers each step for first configuring your Truv Postman Collection.

Steps

1. Install Postman.

2. Fork the Truv API collection.

3. Once both the collection and the environment variables are imported into Postman, see the configuration section below on how to correctly configure API keys with the collection.

Configuring Postman

The Truv Postman collection uses Postman environment variables to simplify each API request.

Steps

1. Select the Sandbox environment in the top right corner
2. Click the eye icon to open the environment settings

1. Copy in your Truv API keys from your Truv Dashboard into each field:
   1. client_id
   2. access_key
2. Save your changes and start making Truv API requests!

Making requests

Start by making different requests to create an order and modify the requestBody payload as desired.

Requests have preconfigured pre-request and post-response scripts setup to pass through sample data and fetch response data to be passed through into subsequent requests.

An MVP journey looks like:

1. Create an Order - VOIE (Basic)
   1. In the responseBody, you can click on the shareURL to complete the order
2. Get an Order by Id
   1. The orderId created in step one will be stored as a variable and should be passed through to this request
3. Get a VOIE Report by Id
   1. The user_id and voie_report_id variables from the prior responseBody will be stored as variables and should automatically be passed through into this request