Set up our Postman collection

With your API keys in hand, let's get you up and running with Postman 📬.

We've created a public Postman workspace so that you can quickly and easily start testing what data you can get using Okra. In this article, you'll learn how to install and configure our collection.


Make sure you've installed the Postman App for Windows, Mac, or Chrome and have logged into your Postman account.

Fork the Okra API Collection

To use Okra API collection:

  1. Go to Okra's Postman workspace and click Watch. This way, if we ever make a change to the collection, you'll be automatically notified and you'll be able to pull the changes into your fork.
  2. Click on Fork to fork the collection into your own private workspace.
Watch the collection in the Okra API WorkspaceWatch the collection in the Okra API Workspace

Watch the collection in the Okra API Workspace

✳️ Done! Let's quickly configure Postman so that you can easily use our API.

Configure Postman

Our Postman collections make use of environment variables to customize the requests that are sent. You can read more about environments in Postman's setting up an environment with variables article.

To create your environment variables:

  1. In Postman, click the eye icon.
  2. In the Environment section, click Add.
Adding an EnvironmentAdding an Environment

Adding an Environment

  1. Name your Environment, for example, Okra Sandbox.
  2. Add the following environment variables:
    • API_KEY: your sandbox API Key
    • secret: your sandbox secret(token).
    • baseUrl:
Configuring the variablesConfiguring the variables

Configuring the variables


Make sure that your ApiKey, secret, and baseUrl are properly stored as the initial value AND current value. This is important to prevent potential errors

  1. Rename the environment to Okra Sandbox
  2. Click Save

✳️ Awesome! But before we go on, let's make sure that everything is working just fine with a simple call.

Test that it works!

Just to make sure you've set everything up correctly, let's see that you can list all the banks in our Sandbox environment.

  1. Make sure that you select your Okra Sandbox environment.
  2. In the Okra API folder, select Bank → GET List.
  3. Click Send.

If everything is correctly set up, you should see a whole host of banks appear!

Testing our APITesting our API

Testing our API

✳️ And you're done!

Did this page help you?