Analytics Aggregations Intelligence Tools Institution FinTech Developer Connect Authentication

Developers Rejoice: Postman & Quovo

As part of Quovo’s ongoing commitment to fostering innovation within the fintech community,  we created a Postman Collection to securely share, sync and collaborate with developers using our Account Aggregation API! Whether you’re an industry veteran or just starting out, Postman will become a welcome addition to any developer’s toolkit. To help you get started, we’ve put together a few easy steps to familiarize yourself with Postman and to get comfortable using it to access our API.

What is Postman?

At its core, Postman is a tool that helps generate and test API calls by providing a clean interface to build and save HTTP requests, and to check and test API responses. To get started with Postman, simply open Google Chrome then click here to install the extension (alternatively, you can download the native application here)!

Quovo has created two Postman Collections for our Aggregation API. The first contains a library of all available API calls, while the second walks you through our sample workflows. To run these Collections, you will need to use the API credentials provided to you by a Quovo team member. If you do not have credentials and would like access to the Quovo API, please contact us at info@quovo.com.

Creating your first request with Postman

Step 1: Download the Quovo API Collection

Click the button below to automatically import the Quovo API Collection into Postman!
Download Postman Collection

Step 2: Configure the Postman Environment

1-configure-environment

Before sending a request from the Quovo API Collection, you must first create a Postman Environment, which is simply a way to store and use variables within your API calls.

To create an Environment in Postman, follow the three steps below:

  1. Click on the Settings button (the Gear icon in the top right) and then select “Manage Environments”
  2. Click the “Add” button on the bottom right to add a new Environment
  3. Enter an Environment name and click the “Add” button again after adding the following key-value pair: base_url: https://api.quovo.com/v2

Now that you’ve setup your Environment, “base_url” can be used inside any API call by adding {{base_url}}. For example {{base_url}}/users will automatically replace {{base_url}} with the string “https://api.quovo.com/v2“.

Step 3: Configure the Postman Authorization Header

Making requests to the Quovo API requires an API Access Token. This Token is used to authenticate and identify any incoming API request. To create your Access Token:

  1. Navigate to the “Create a new Access Token” Postman request, listed under the “Tokens” folder
  2. Click on the “Authorization” tab
  3. Select “Basic Auth” as the authorization “Type”
  4. Enter your API credentials
  5. Click “Update Request”
  6. Click “Send”

2-configure-header

This request will return your new Access Token in the “token” field of the JSON response. To use the Access Token on future API calls make sure that it’s stored as the Environment variable, {{token}}. The “Create a new Access Token” Postman request will automatically set this variable for you. Click on the Eye icon in the top right to view your current Environment variables.

Once you have an Access Token stored you will want to make sure your request headers are properly configured to send it. Each request should contain the Token as a Bearer Token. On any Postman request: click the “Headers” tab, then enter the key-value pair Authorization: Bearer {{token}}. This will already be configured for any request within the Quovo Postman Collections.

Step 4: Generate Code with Postman

3-generate-code

One useful feature of Postman is the ability to generate code from any built request. Each call that you make in Postman can be used to produce equivalent code in the language of your choice. To generate the code, click the button labeled “Code” in the top right corner, and then select your prefered programming language from the drop down menu.

Step 5: Download the Quovo API Basic Workflows

Click the button below to automatically import the Quovo API Workflows into Postman.
Download Postman Workflows

Step 6: Read through the Quovo API documentation

Still looking for more detail? You can always find more information in our API documentation!

Like what you've read?

Sign up to receive email updates with the latest on the Fintech Blog.