1. [    Home ](/)
2. [Guides](/guides)
3. [Getting Started](/guides?category=26)
4. Building a Postman Collection
 
 beginner Getting Started      12 min       4 steps      6 min read  

# Building a Postman Collection

  A  admin  April 15, 2026  

 

 

       

 

 

 

 

 ##     Prerequisites 

 

 

 

 

 ## On this page

  
  4 steps total 

 [    Back to top ](#main-content) 

 ## Prerequisites

Download and install [Postman](https://www.postman.com/downloads/) (free). Have your Aelix API key or OAuth credentials ready.

## Step 1 — Create an Environment

In Postman, click **Environments → Create Environment** and add these variables:

VariableValueTypebaseUrl<https://api.aelix.digitalapi.ai>defaultapiKey(your key)secretclientId(your client\_id)secretclientSecret(your client\_secret)secretaccessTokendefault (auto-populated)## Step 2 — Import the Collection

Download the official Aelix Postman collection from the Developer Portal under **Documentation → Downloads → Postman Collection**, or use the public link:

<https://aelix.digitalapi.ai/postman/aelix-apis-v1.json>

In Postman, click **Import → Link** and paste the URL.

## Step 3 — Set Up Auto-Authentication

The collection includes a pre-request script that automatically fetches and caches an access token. To enable it, set your clientId and clientSecret in the environment you created in Step 1.

## Step 4 — Send Your First Request

Expand the collection, open **ATM Locator → Search ATMs by Postcode**, ensure your environment is active, and click **Send**. You should see a 200 response with nearby ATM data.

### Exporting for CI/CD

Use **Newman** to run your Postman collection in automated pipelines:

npm install -g newman  
newman run aelix-apis-v1.json \\  
\--environment aelix-prod.json \\  
\--reporters cli,junit \\  
\--reporter-junit-export results.xml



 

 

 

 ### Tags

Tags

[Postman](/taxonomy/term/39)

[REST](/taxonomy/term/36)