Import data into Postman

You can import collections, API definitions, and other data files so you can work with them in Postman.

To import your data into Postman, select Import in the sidebar. You can import your data from files, folders, cURL commands, raw text, or URLs. You can also import data from other sources such as code repositories, API gateways, API clients, and application performance management tools.

Import data into Postman

You can also import items by dragging and dropping files or folders into Postman.

Import Postman data

You can import data that was exported from Postman, including collections, environments, globals, and data dumps. Postman will automatically recognize Postman data on import.

  1. Select Import in the sidebar.

  2. Do one of the following:

    • Select your file or folder, or drag the file or folder into the import window.

      If you are importing a Postman data dump or other zipped file, you must unzip it first. Then drag the unzipped folder into the import window. Learn more about exporting and importing data dumps.

    • Paste your raw text or URL into the box.

    • Select Other Sources and select the type of data you want to import.

      You can import data from a GitHub, Bitbucket, GitLab, or Azure code repository. You can also import an API from AWS API Gateway or Azure API Management, or import data from New Relic.

  3. If you're importing multiple files, select the files you want to import, then select Import.

    Import Postman data

    If you are importing a single file, Postman imports it after you select it.

  4. An Import Complete message displays in the footer. In the message, select the link icon External link icon next to a collection or environment to open the imported element.

    Import complete message

Convert Postman collections from v1 to v2

Postman no longer supports the collection v1 format and will return an error if you import a collection in this format. You can convert your collection's format from v1 to v2 to import it into Postman.

To convert your collection's format from v1 to v2, do the following:

  1. In the terminal of your choice, enter the following command to install the Postman Collection Transformer.

    sudo npm install -g postman-collection-transformer
  2. Convert an individual Postman Collection from v1 to v2 by entering this command:

    postman-collection-transformer convert -i <path to the input Postman Collection file> -o <path to the downloaded Postman file> -j 1.0.0 -p 2.0.0 -P

The resulting collection will download to your target file path in v2 format.

You can retrieve a list of convert options by running the command with the -h flag:

postman-collection-transformer convert -h

Go to the Postman Collection Transformer for more information about collection conversion.

Migrate from other API Clients

Postman can import requests, environments, and other data from the following API clients:

Import from cURL commands

To learn more about using cURL commands to import data, go to Import cURL commands.

Import API definitions

To learn more about importing your API definitions into Postman, go to Import an API into Postman.

Last modified: 2023/10/18