Add API requests to Postman Collections

View as Markdown

After you create a Postman Collection, you can use it to save and organize API requests. Use any of the methods below to add requests to a collection. You can add HTTP requests to a collection, or you can add requests that use other protocols to a multi-protocol collection.

Add a request to an empty collection

You can add a request to a new collection by doing the following:

  • Hover over the collection in the sidebar and click Add icon Add request.

  • Expand the new collection and click Request icon Add Request.

  • Hover over the collection in the sidebar, click Options icon View more actions, then select Add request.

    Add a request to an empty collection

Save a new request to a collection

  1. Open a new request and click Save icon Save.
  2. Enter a name for the request.
  3. Select the collection you want to save the request to. Or click New Collection to create a new collection.
  4. Click Save.

Create a new request inside a collection

To save a new request directly to a collection, you can do the following:

  • In the sidebar, click Options icon View more actions next to a collection and select Add request.
  • Hover over the collection and click Add icon Add request.

Save a request from your history to a collection

  1. Click History icon History in the sidebar.
  2. Hover over the request and click Save Request.
  3. Select the collection you want to save the request to. To create a new collection to save the request to, click New Collection.
  4. Click Save.

Move an existing request to a different collection

  1. In the sidebar, select the request you want to move. You can hold or Ctrl to select multiple requests.
  2. Drag the request into another collection.

You can also open the request and select Save icon Save > Save as, then select the collection you want to move it to.

About multi-protocol collections

You can add non-HTTP requests to a collection, which then becomes a multi-protocol collection.

To create a multi-protocol collection, do the following:

  1. Click Add icon Add in the sidebar.
  2. Choose the protocol you want to start a multi-protocol collection with.
  3. Click Save, then add it to a new collection or save it to an existing multi-protocol collection.