Skip to navigation

Create collections of API requests in Postman

View as Markdown

Create a Postman Collection to save and share your favorite requests, to group requests you use for testing an API, or to document your API.

Once created, you can customize your collection by adding a name and description. You can also specify authorization details and add scripts and variables.

Create a new collection

To create a collection, you must be signed in to your Postman account.

You can create a new collection in the following ways:

  • Click Collections in the sidebar, then select + > Blank collection.
  • Click New in the sidebar, then click Collection.
  • In an empty workspace, click Create Collection.

Once you’ve created a new collection, you can add API requests to it. You can also name and configure your collection.

Create new collection

Configure a collection

To customize and configure your new collection, do any of the following:

  • Click the collection name in the workbench to rename your collection. You can also select a collection in the sidebar and press the Enter or Return key to rename it.
  • You can add a description for your collection in the Overview tab. The description also appears in the collection’s documentation.
  • Click Authorization to configure authorization details for all requests in the collection.
  • Select Scripts > Pre-request to add a pre-request script for your collection. The script will run before each request in the collection is sent.
  • Select Scripts > Post-response to add a post-response script for your collection. The script will run after each request in the collection is sent.
  • Click Variables to define collection variables. Collection variables are reusable values you can use across all requests and documentation in a collection.

Double-click a collection in the sidebar to persist its tab as you navigate the Postman app.

Edit collection details

Turn on autosave to automatically save your changes to requests. Learn more about autosave.