Creating collections

What is a Postman Collection?

A Postman Collection lets you group individual requests together. You can organize these requests in folders.

Why create collections?

Organization - Group together requests into folders and collections, so that you don’t have to search through your history repeatedly.
Documentation - Add a name and descriptions to requests, folders, and collections. In Postman, you can use the collection browser to view the documentation. In Postman Pro, you can create and publish beautiful API documentation pages.
Test suites - Attach test scripts to requests and build integration test suites.
Conditional workflows - Use scripts to pass data between API requests and build workflows that mirror your actual API use case.

Creating a new collection

You can create a new collection from the:

Sidebar
New button
Launch screen

In the sidebar, select “Collections” and click the “Collections” icon.

In the CREATE A NEW COLLECTION modal:

Enter a name and optional description.
Select an authorization type.
Enter a pre-request script to execute before the collection runs.
Add a test to execute after the collection runs.
Add variables to the collection and its requests.

Click the Create button.

New button

In the header toolbar, click the New button.

The Create New tab appears.

In the Create New tab, click "Collection".
In the CREATE A NEW COLLECTION modal:

Enter a name and optional description.
Select an authorization type.
Enter a pre-request script to execute before the collection runs.
Add a test to execute after the collection runs.
Add variables to the collection and its requests.

Click the Create button.

After creating the collection, you can save requests to the collection and add folders for better organization.

Note: At the bottom, you can select “Show this window at launch” to indicate whether you want the Create New tab to display each time you open Postman.

Launch screen

The Create New tab appears by default when you launch Postman.

Open Postman.
In the Create New tab, click “Collection”.
In the CREATE A NEW COLLECTION modal:
- Enter a name and optional description.
- Select an authorization type.
- Enter a pre-request script to execute before the collection runs.
- Add a test to execute after the collection runs.
- Add variables to the collection and its requests.
Click the Create button.

After you save the request, you can add the URL, method, headers, and body to the request in the builder.

Note: At the bottom, you can select “Show this window at launch” to indicate whether you want the Create New tab to display each time you open Postman.

Saving a request to a collection

You can save a request to a collection from the:

Request builder
New button
Launch screen

Request builder

In the request builder, enter a new request in the builder.
Click the Save button.
In the SAVE REQUEST modal, enter a request name and select a collection or folder to save the request.
Click the Save button.

New button

In the header toolbar, click the New button.
Click “Request”.
In the SAVE REQUEST modal, enter a request name and select a collection or folder to save the request.
Click the Save button.

After you save the request, you can add the URL, method, headers, and body to the request in the builder.

Note: At the bottom, you can select “Show this window at launch” to indicate whether you want the Create New tab to display each time you open Postman.

Launch screen

The Create New tab appears by default when you launch Postman.

Open Postman.
In the Create New tab, click “Request”.
In the SAVE REQUEST modal, enter a title and description.
Select a collection and save the request in an existing collection or create a new collection.
Click the Save button.

Note: At the bottom, you can select “Show this window at launch” to indicate whether you want the Create New tab to display each time you open Postman.

Saving to a collection from history

Single request

To save a single request to a collection, hover over a request under the History tab and click the plus (+) icon.
In the SAVE REQUEST modal, enter a title and description, select a collection, and save the request in an existing collection or create a new collection.
Click the Save button.

Multiple requests

To save multiple requests, click the plus (+) icon that displays at the top of the sidebar.
In the SAVE MULTIPLE REQUESTS modal, select a collection or folders to save the requests.
Click the Save button.