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 (e.g. collections) as well as your API specifications directly into Postman.

To import your data into Postman, click Import in the upper-left corner.

Import modal

You can import your data via 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, click 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. Click Import to bring your data into Postman.

Import collection and environment

Importing API specifications

Postman supports the following API specification formats:

To import your API specifications into Postman, click 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 click 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 click 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 > Connect to GitHub.

Import from github

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

Import from github

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

Select org, repo, branch

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 github import

You will receive a confirmation once the import has completed.

Import completed

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

Imported data in app

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. Click Export to download your newly generated JSON file.

Export collection format

Learn more about Postman's v1 and v2 formats.

Exporting environments

You can export your environments from Postman by selecting the gear icon in the upper-right corner to open Manage Environments. Click the download symbol next to your environment 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 wrench icon in the upper-right corner to open Settings. Click to open the Data tab, then Download to save the newly generated JSON file of your Postman data.

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.