---
title: Setup the Tally Platform API via Postman
slug: setup-the-tally-platform-api-via-postman
docTags: 
createdAt: 2025-09-12T14:38:30.920Z
---

This documentation guides you through setting up and using the Tally Platform APIs via Postman. It provides step-by-step instructions for configuring your environment, authentication, and executing API requests.

## Prerequisites

The Postman application must be installed on your device. If it's not installed, download from: [Download Postman | Get Started for Free ](https://www.postman.com/downloads/)

You will need the Tally API file, as well as the environment and user files provided by our team. 

## Setup Instructions

### Import Files

1. Open Postman and click  **Import** in the top-left corner.
2. Click on **Select Files** and navigate to the downloaded collection and environment files.
3. Confirm import when prompted.

### Environment Configuration

1. After importing, locate the environment dropdown menu in the top-right corner and select your default environment.
2. This environment contains predefined variables required for API execution.

### Authentication

1. Click on **Tally Platform Services** in the collections panel.
2. Navigate to the **Authorization** tab and enter your **Client ID** and **Client Secret**.* Reach out to our team if you have questions about authentication.*
3. Scroll to the bottom and click **Get New Access Token.**
4. Wait a few seconds while the authentication token is generated. Click **Use Token** when prompted.
5. Authentication is now complete, and you can begin using the APIs.

If the token expires, repeat the steps to generate a new token.

##  API Structure and Variables

### Environment Variables

Key variables are preconfigured in the environment:

- Base URL
- AccountNumber
- Various required IDs

### Variable Management

When first imported, environment variable values are blank by default. Variables are automatically populated as you execute API calls.

Examples: 

- Running "Enroll Member" will populate the accountNumber variable.
- Running "Create Member Address" will populate the MemberAddressID variable.

You can also manually set values if needed.

### API Organization

The API collection is organized into functional folders: for example, **member-promotion **contains:

- GET Get Member Promotions
- POST Register member for promotion
- GET Get Member Promotion By Member Promotion ID

You can also browse our [API reference documentation here](https://docs.wearephaedon.com/tally-platform-api). 

## Use the APIs

1. Expand the relevant folder in the collection.
2. Select the API you wish to execute.
3. Review any required parameters or body content.
4. Click **Send** to execute the request.
5. Review the response in the lower panel.