> For the complete documentation index, see [llms.txt](https://www.pranaypourkar.co.in/the-programmers-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.pranaypourkar.co.in/the-programmers-guide/api/api-testing/tools/postman.md).

# Postman

## About

**Postman** is one of the most widely used tools for working with APIs. It provides a powerful, user-friendly interface to send requests, inspect responses, and automate testing. Postman supports both REST and SOAP APIs and is equally useful for developers, testers, and DevOps engineers.

<figure><img src="/files/aJmbKffaYBSio7nV2tEL" alt=""><figcaption></figcaption></figure>

## What is Postman ?

Postman is an API platform that allows us to develop, test, document, and monitor APIs in one place. It started as a simple Chrome extension but has grown into a full-fledged desktop and web application used across the software industry.

We can manually send HTTP requests (like GET, POST, PUT, DELETE), view responses, and organize our API workflows into collections. It also supports automation, collaboration, and mocking.

## Installing Postman

Postman is available as a **desktop application** and also has a **web version**. For full functionality (especially testing with local servers), the desktop app is recommended.

### 1. **Download Postman**

Visit the official Postman website:

[**https://www.postman.com/downloads/**](https://www.postman.com/downloads/)

Choose the version suitable for our operating system:

* Windows (x64, x86)
* macOS (Intel or Apple Silicon)
* Linux (Ubuntu, Debian, Fedora, etc.)

### 2. **Install on Windows**

* Download the `.exe` installer.
* Double-click to run it.
* Follow the on-screen installation steps.
* Once installed, launch Postman and sign in or create a free account.

### 3. **Install on macOS**

* Download the `.zip` file for macOS.
* Unzip and drag the Postman app to the Applications folder.
* Launch it from Applications and sign in.

### 4. **Install on Linux (Ubuntu/Debian)**

Using Snap (recommended):

```bash
sudo snap install postman
```

Or download the `.tar.gz` from the website and extract it manually if Snap is not available.

### 5. **Using Postman on the Web**

If we prefer not to install anything:

* Go to <https://web.postman.co>
* Sign in with our account.
* Start using Postman directly from the browser.

Note: Some features like sending requests to `localhost` may not work on the web version due to browser restrictions.

### 6. **Create an Account (Optional but Recommended)**

Creating a free Postman account enables features like:

* Syncing collections and environments
* Collaboration with teams
* Access to Postman Cloud features

## Features

### **1. Request Building**

We can build and send HTTP requests easily by choosing the method (GET, POST, etc.), adding headers, query parameters, path variables, request bodies (JSON, form data, etc.), and then hitting "Send."

### **2. Collections**

Collections are groups of API requests saved in an organized way. We can share these with our team or export them to be used in automation tools like Newman.

### **3. Environment Variables**

We can define environments like `dev`, `test`, `prod` with variables such as base URLs, tokens, etc. This makes it easy to switch between environments without changing requests manually.

### **4. Pre-request Scripts and Tests**

Postman supports writing scripts using JavaScript. These can run:

* **Before** the request is sent (e.g., to set a token dynamically)
* **After** the response is received (e.g., to validate status code or response content)

### **5. Mock Servers**

Mock servers allow we to simulate an API endpoint that returns a fixed response. This is useful during development if the backend isn’t ready yet.

### **6. Monitors**

We can schedule collections to run periodically using monitors. It helps we verify that our APIs are working as expected over time.

### **7. Documentation**

Postman can auto-generate API documentation from our collections, which can then be published and shared.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://www.pranaypourkar.co.in/the-programmers-guide/api/api-testing/tools/postman.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.