Importing and exporting data

Postman can import and export Postman data, including collections, environments, data dumps, and globals. Postman can also import non-Postman data in the form of API schemas to help you consolidate your API development workflow.

Contents

Importing data into Postman

You can import collections or your API specifications directly into Postman.

To import your data into Postman, select Import in the left navigation menu.

Import modal

You can import your data from files, folders, links, raw text, or GitHub repositories.

Importing Postman data

You can import Postman data you previously exported, including collections, environments, data dumps, and globals.

To import Postman data, select Import. Select your file or folder, input your link, paste your raw text, or import from GitHub. Postman will automatically recognize Postman data, confirming the name, format, and what the file will import as. Select Import to bring your data into Postman.

Import collection and environment

Converting Postman collections from v1 to v2

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

Collection v1 format

You can take the following steps to convert the Postman collection format from v1 to v2.

In the terminal of your choice, enter the following command to install the Postman collection transformer.

sudo npm install -g postman-collection-transformer

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

postman-collection-transformer convert -h
Option Details
-h, --help Outputs usage information
-i, --input <path> Returns a path to the input postman collection file
-j, --input-version [version] Returns the version of the input collection format standard (v1 or v2)
-o, --output <path> Returns a path to the output postman collection file
-p, --output-version [version] Returns the version of the output collection format standard (v1 or v2)
-P, --pretty Prints the output in pretty format
--retain-ids Retains the request and folder IDs during conversion (collection ID is always retained)
-w, --overwrite Overwrites the output file if it exists

You can convert an individual Postman collection from v1 to v2 by entering the command below.

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

The resulting collection will be in v2 format and downloaded to your target file path. See the Postman Collection Transformer for more information on the collection conversion.

Importing API specifications

Postman directly supports importing the following formats:

There are also tools on GitHub to convert the following into a Postman collection for import:

To import your API specifications into Postman, select Import. Select your file or folder, input your link, or paste your raw text. Confirm the name, format, and what you would like your data to import as, then select Import to bring your data into Postman.

Import file

You can configure your Import Settings, which will differ depending on your API specification.

You can import several API specification files at once. Select the workspace you'd like to import the APIs into, choose whether you want to generate collections from the APIs, configure the details, and select Import.

When importing into a team workspace, you can also choose to add the APIs to the Private API Network.

Import several APIs

Importing via GitHub repositories

You must be signed in to a Postman account to use this feature.

You can import data in bulk from a GitHub repository by selecting Import > Code repository > GitHub.

Import from github

Confirm your GitHub account and Authorize postmanlabs to access your repositories.

Import from github auth

In Postman, select your GitHub organization, repository, and branch, then Continue.

Import from github auth

Confirm the files you would like to import into Postman. You can also opt to Generate collection from imported APIs and select what you would like to link this collection as. Click Show advanced settings to control how Postman should generate collections based on your file types, then select Import.

Confirm import from github

You will receive a confirmation once the import has completed.

Confirm complete import from github

You can now view your newly imported files and generated collections in Postman.

Importing via Bitbucket repositories

You must be signed in to a Postman account to use this feature.

You can import data in bulk from a Bitbucket repository by selecting Import > Code repository > Bitbucket.

Import from bitbucket

Confirm your Bitbucket account and Authorize Postman to access your repositories.

Import from bitbucket auth

In Postman, select your Bitbucket workspace, repository, and branch, then Continue.

Import from bitbucket auth

You will see a preview of the files that will be imported to your workspace. Select Import to confirm and complete the import.

Confirm import from bitbucket

You will receive a confirmation once the import has completed.

Confirm complete import from bitbucket

You can now view your newly imported files and generated collections in Postman.

Confirm complete import from bitbucket

Exporting Postman data

You can export your Postman data, including collections, environments, data dumps, and globals, as JSON files. These files can be imported back into any Postman instance, or utilized by Newman, Postman's command-line collection runner.

Exporting collections

You can export your collections from Postman by selecting the ... next to the collection, then Export.

Export collection menu

You can then select the format you'd like your collection to export as. Select Export to download your newly generated JSON file.

The export to Collection v1 format is no longer supported in Postman.

Export collection format

Learn more about Postman's collection formats.

Exporting environments

You can export your environments from Postman by selecting the Environments tab from the left navigation menu. Select the environment you need to export.

Export environment

In the top right corner, select the .... Select Export to download your newly generated JSON file.

Export environment menu

Exporting data dumps

You can export a data dump of all of your collections, environments, globals, and header presets in Postman.

Select the gear icon in the upper-right corner to open Settings.

Export data dump

Select the Data tab, then Export Data to start your request for the dat dump.

Export data dump

Select Export Data to confirm the data types you need to export.

Export data dump

Select Request Data Export to submit the request.

Export data dump

When the export is ready, you will receive an email with link to download a zipped file with the data dump.

Export data dump

Next steps

You can collaborate on collections by sharing and commenting to discuss your API projects with team members. Learn more about Postman's API workflow.