Skip to main content

Importing Postman Collections, Variables, and Environments

If you have a Postman API Collection, you can import it directly into API Testing on Sauce Labs and use it to generate tests.

What You'll Need#

  • A Sauce Labs account (Log in or sign up for a free trial license).
  • A Postman Collection that's v2 or higher. We no longer support the Postman v1 Collection format, which was deprecated by Postman.
  • An existing API Testing Project. For details on how to create one, see API Testing Quickstart.

Importing Postman Collections#

  1. Log in to Sauce Labs, then click API Testing > Get Started.
    API Testing landing page
  2. Click to open one of your Projects.
  3. Click the HTTP Client tab.
    HTTP Client
  4. Click the Import OpenAPI / Postman button, then select and upload your Postman Collection file from your local machine.
    Import OpenAPI / Postman button
tip

If you don't have a file available, try out the sample below.

Click here to open sample Postman Collection file
Copy the text below, paste text into a text editor, then save that as a .json file.

demo_postman_collection.json
{  "info": {    "_postman_id": "901ae894-37d4-45c1-b1bc-bd6b31762bfe",    "name": "demoapif",    "description": "Call to the APIF demo API All Products Get.",    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"  },  "item": [    {      "name": "product",      "item": [        {          "name": "List All Products",          "request": {            "auth": {              "type": "oauth2",              "oauth2": [                {                  "key": "addTokenTo",                  "value": "header",                  "type": "string"                }              ]            },            "method": "GET",            "header": [              {                "key": "Accept",                "value": "application/json"              },              {                "key": "key",                "value": "ABC123",                "type": "text"              }            ],            "url": {              "raw": "http://demoapi.apifortress.com/api/retail/product",              "protocol": "http",              "host": [                "demoapi",                "apifortress",                "com"              ],              "path": [                "api",                "retail",                "product"              ]            }          },          "response": []        }      ],      "description": "Folder for product"    }  ]}
  1. Click the folder your Snapshots tree where you'd like to save your file.
    Routes Rendered
  2. Click Save.
    Import file to Project
  3. The routes from your collection will now show in the list of saved requests.
    Import file to Project

Importing Postman Environments#

  1. Log in to Sauce Labs, then click API Testing > Get Started.
    API Testing landing page
  2. Click to open one of your Projects.
  3. Click the Vault tab.
    Project Vault
  4. Click Variables.
    Project Vault Variables
  5. Click Import.
    Project Vault Import
  6. Select and upload your .postman_environment.json file.

Your environmental variables will now be available in the Variables section of your Project.

Importing Postman Variables#

  1. Log in to Sauce Labs, then click API Testing > Get Started.
    API Testing landing page
  2. Click the Company Vault tab.
    Company Vault
  3. Click the Variables radio button.
    Company Vault
  4. Click Import.
  5. Select and upload your .postman_environment.json file.

Your environmental variables will now available across all your Projects.

More Information#