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:

  • In the sidebar, click Add icon and select Collection.
  • In a new workspace, expand Collections in the sidebar and click Add icon Create.

These methods create a collection that can contain HTTP requests only. To create a collection that can contain non-HTTP requests, save a non-HTTP request to a new 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.

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

Edit collection details