- Installation and updates
- Sending the first request
- Creating the first collection
- Navigating Postman
- Keyboard Shortcuts
- Postman account
- New button
- Troubleshooting In-app Issues
- Customizing Postman
- Find and Replace
- Troubleshooting API requests
- Debugging and logs
- Capturing HTTP requests
- Interceptor extension
- Generate code snippets
- Making SOAP requests
- Working with Tabs
- Using GraphQL
- Visualize API responses
- Intro to collections
- Creating collections
- Sharing collections
- Managing collections
- Using Markdown for descriptions
- Data formats
- Working with OpenAPI
- Commenting on collections
- Version Control for Collections
- Intro to scripts
- Pre-request scripts
- Test scripts
- Test examples
- Branching and looping
- Postman Sandbox
- Postman Sandbox API reference
- Intro to environments and globals
- Manage environments
- Manage globals
- Variables complete reference
- Dynamic Variables List
- Intro to collection runs
- Starting a collection run
- Using environments in collection runs
- Working with data files
- Running multiple iterations
- Building workflows
- Sharing a collection run
- Debugging a collection run
- Command line integration with Newman
- Integration with Jenkins
- Integration with Travis CI
- Newman with Docker
- Intro to API documentation
- Viewing documentation
- Local environments and shared environments
- How to document using Markdown
- Publishing public docs
- Adding and verifying custom domains
- Adding team name and logo
- Intro to Monitoring
- Setting up a monitor
- Viewing monitor results
- Monitoring APIs and websites
- Set up integrations to receive alerts
- Pricing for monitors
- Troubleshooting monitors
- FAQs for monitors
- Intro to mock servers
- Setting up a mock server
- Mocking with examples
- Mocking with the Postman API
- Matching algorithm
- Introduction to APIs
- Managing APIs
- Sharing APIs and managing roles
- The API Workflow
- Versioning APIs
- Reporting FAQs
- Viewing and analyzing APIs
- Intro to Workspaces
- Creating Workspaces
- Managing Workspaces
- Using Workspaces
- Sharing collections in Workspaces for version 5
- Activity feed and restoring collections
- What is Postman Pro
- Purchasing Postman Pro
- Billing and pricing
- Upgrading to Postman Pro from a trial team
- Team Settings
- Changing your plan
- Managing your team
- Migrating to Postman v7
- Roles and permissions
- Managing your billing
- Intro to Enterprise
- Purchasing Postman Enterprise
- Running Postman monitors using static IPs
- Intro to SSO
- Configuring SSO for a team
- Logging in to an SSO team
- Configuring Microsoft AD FS with Postman SSO
- Setting a custom SAML in Azure AD
- Setting up custom SAML in Duo
- Setting up custom SAML in GSuite
- Setting up custom SAML in Okta
- Setting up custom SAML in Onelogin
- Setting up custom SAML in Ping Identity
- Audit logs
- Public API documentation
Installation and updates
Postman is available as a native app for macOS, Windows (32-bit and 64-bit), and Linux (32-bit and 64-bit) operating systems.
To get the latest version of the Postman app, go to the download page and click Download for macOS / Windows / Linux depending on your platform.
Once you’ve downloaded and unzipped the app, double click on Postman. You will be prompted to move file into the "Applications" folder. Click "Move to Applications Folder" to ensure future updates can be installed correctly. The app will open after the prompt.
- Download the setup file
- Run the installer
For installation on Linux, perform the following steps:
- First download and unzip the file
And then create a desktop file by name Postman.desktop. Create the
Postman.desktopfile in the following location:
Use the content below in the above file:
[Desktop Entry] Encoding=UTF-8 Name=Postman Exec=YOUR_INSTALL_DIR/Postman/app/Postman %U Icon=YOUR_INSTALL_DIR/Postman/app/resources/app/assets/icon.png Terminal=false Type=Application Categories=Development;
Postman.desktop file is created, the Postman app can be opened using application launchers. You can check your desktop and double-click the Postman icon.
- Avoid starting Postman using
sudocommand, this will create permission issues on the files created by Postman.
- Make sure you have read/write permission for
~/.configfolder where Postman stores the information
- If you are an Ubuntu 18 user, you must additionally install libgconf-2-4 package to ensure a smooth Postman run. This package, shipped by default until Ubuntu version 18, has been dropped, and is mandatory for Postman to run. Use the following command to install
apt-get install libgconf-2-4
This section describes the additional software and infrastructure you'll need to run Postman. Please review this info before installing Postman. You should only use Postman with a supported platform. Any platforms and versions not listed on this page are unsupported, which means we don't test, fix bugs or provide assistance.
The minimum version supported is macOS 10.9.
Postman supports Windows 7 and above. Older operating systems are not supported.
ia32 (x86) and x64 (amd64) installers are provided for Windows. Note that the ARM version of Windows is not supported.
Postman supports the following Linux distributions:
- Ubuntu 12.04 and later
- Fedora 21
- Debian 8 and later
If you are an Ubuntu 18 user, you must additionally install
libgconf-2-4 package to run Postman. This package, which was shipped by default until Ubuntu version 18 has been dropped, and is mandatory to run Postman. Use the following command to install
apt-get install libgconf-2-4
We recommend using the Postman native apps, but Postman is also available as a Chrome app. Read more about why support for the Postman Chrome app is being deprecated.
The Postman Chrome app can only run on the Chrome browser. To use the Postman Chrome app, you will first need to install Google Chrome.
If you already have Chrome installed, head over to Postman’s page on the Chrome Web Store, and click ‘Add to Chrome’.
The download should take a few minutes depending on your internet connection. Once you’ve downloaded the app, you can launch Postman.
Postman's native apps are built on Electron, and overcome a number of restrictions of the Chrome platform.
A few features exclusive to the native apps are listed here:
The native apps come with a built-in proxy that you can use to capture network traffic.
The native apps are not restricted by the Chrome standards for the menu bar. With the native apps, you can check for updates, create Postman Windows and tabs, edit preferences, and can perform many other tasks. More on navigating the Postman App.
The latest versions of the native apps let you send headers like
User-Agent. These are restricted in the Chrome app.
This option exists in the native apps to prevent requests that return a 300-series response from being automatically redirected. Previously, users needed to use the Interceptor extension to do this in the Chrome app.
The latest version of the native app also has a built-in console, which allows you to view the network request details for API calls.
Alternatively, if you don't want to sign in to your Postman account, you can bulk export your Postman data from the Chrome app, and then bulk import into the new native app.
From the Postman settings, select the Data tab and click the Download button to export all your collections, environments, globals and header presets to a single dump file.
From the same area in Postman settings, you can initiate a bulk import from a Postman data dump file. This will overwrite your existing data so be careful. Read more about bulk import.
Postman's native apps will notify you when a major update is available. Other updates are indicated by a dot that appears on the settings icon. If the indicator is red instead of orange, it indicates a failed update.
Click Update to download the latest update. You will be notified when the download is complete prompting you to restart the Postman app to apply the updates. If you're not ready to update yet, click Later to auto update after the next app launch.
You can also configure your preferences to enable automatic download for major updates under the Update tab within the SETTINGS modal. Postman automatically downloads minor updates and bug fixes.
This warning is expected while installing Postman v7.6.0 and above. Please following the steps below to install the application if you get this warning:
- Click on "More info"
- Click on "Run anyway"
For more details on why this warning is shown by Windows Operating System, please refer this post on our community forum.
Some users may encounter issues updating in the Windows version of Postman 6.1. To resolve you must set the environmental variable
POSTMAN_DISABLE_GPU=true. In order to do this, follow these steps:
Advanced system settings
- Navigate to
- Add a new system variable and save by click 'OK'.
While updating the app there might be some issues due to which the user would see the following modal.
You can find more details about the error from the DevTools. Open it from
View -> Developer -> Show DevTools (Current View). Following is a list of most common errors:
Cannot update while running on a read-only volume
Issue: User does not have write permission in the directory where Postman is installed
Resolution: Move Postman to a directory where the user has write permissions. We recommend moving Postman to
/Applicationdirectory for Mac and to the home directory for Linux users.
Code signature at URL file:///... did not pass validation: code object is not signed at all"
Issue: There are multiple updates running at the same time. This can happen when the app is opened before the previous update could finish
Resolution: Quit and reopen the app
If you are using Postman for Linux, and had installed the app via 'Ubuntu Software Center' or 'Snap Store', you would see that there is no
Check for updates button. This is because the updates are handled by Snap itself and it would automatically update Postman on a regular cadence. It you are on Postman v6, you would have to migrate your team to Postman v7 and then change the Snap channel to get the latest updates. For more information see Migrating to Postman v7.
Postman's Chrome app has been deprecated. Although you can still use it, new features and bug fixes are being released exclusively in our native apps. We recommend you download the free native Postman app available for Mac, Windows, and Linux operating systems.