{ "componentChunkName": "component---src-templates-doc-jsx", "path": "/docs/getting-started/importing-and-exporting-data/", "result": {"data":{"markdownRemark":{"html":"

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.

\n

Contents

\n\n

Importing data into Postman

\n

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

\n

To import your data into Postman, select Import in upper left:

\n

\"Import

\n

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

\n

Importing Postman data

\n

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

\n
    \n
  1. Select Import in the left navigation menu.
    2. \n
  2. Select your file or folder, input your link, paste your raw text, or import from GitHub.\nPostman will automatically recognize Postman data, confirming the name, format, and what the file will import as.\n\"Import
    3. \n
  3. Select the files you want to import.
    4. \n
  4. Select Import to bring your data into Postman.
    5. \n
\n

Converting Postman collections from v1 to v2

\n

Postman no longer supports the collection v1 format and will return an error if you try to import a collection in this format.

\n

You can convert your collection's format from v1 to v2 to import it into Postman:

\n
    \n
  1. \n

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

    \n
    sudo npm install -g postman-collection-transformer
    \n
    2. \n
  2. \n

    Convert an individual Postman collection from v1 to v2 by entering the command below.

    \n
    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
    \n
    3. \n
\n

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

\n

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

\n
postman-collection-transformer convert -h
\n

See the Postman Collection Transformer for more information on the collection conversion.

\n

Importing API specifications

\n

Postman directly supports importing the following formats:

\n\n

There are also tools on GitHub to convert different specifications into a Postman collection for import:

\n\n

To import your API specifications into Postman:

\n
    \n
  1. Select Import in the left navigation menu.
    2. \n
  2. Select a file or folder, input a link to the API, or paste your raw text. Confirm the name, format, and what you would like your data to import as.
    3. \n
  3. Select Import to bring your data into Postman.
    4. \n
\n
\n

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

\n
\n

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.

\n

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

\n

\"Import

\n

Importing via GitHub repositories

\n
\n

You must sign in to a Postman account to use this feature.

\n
\n

You can import data in bulk from a GitHub repository.

\n
    \n
  1. \n

    Select Import > Code repository > GitHub.

    \n
    2. \n
  2. \n

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

    \n
    3. \n
  3. \n

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

    \n
    4. \n
  4. \n

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

    \n

    \"Confirm

    \n
    5. \n
\n

You will receive a confirmation once the import has completed. You can now view your newly imported files and generated collections in Postman.

\n

Importing via Bitbucket repositories

\n
\n

You must sign in to a Postman account to use this feature.

\n
\n

You can import data in bulk from a Bitbucket repository.

\n
    \n
  1. \n

    Select Import > Code repository > Bitbucket.

    \n
    2. \n
  2. \n

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

    \n
    3. \n
  3. \n

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

    \n
    4. \n
  4. \n

    Postman shows a preview of the files to import into your workspace. Select Import to confirm and complete the import.

    \n
    5. \n
\n

You will receive a confirmation once the import has completed. You can now view your newly imported files and generated collections in Postman.

\n

Exporting Postman data

\n

You can export your Postman data, including collections, environments, data dumps, and globals, as JSON files. You can import these files back into any Postman instance, or use them with Newman, Postman's command-line collection runner.

\n

Exporting collections

\n
    \n
  1. \n

    Select \"Three next to the collection, then select Export.

    \n\"Export\n
    2. \n
  2. \n

    Select the format you'd like your collection to export as.

    \n
    \n

    Learn more about Postman's collection formats.

    \n
    \n
    3. \n
  3. \n

    Select Export to download your newly generated JSON file.

    \n
    4. \n
\n

Exporting environments

\n

You can also export your environments from Postman.

\n
    \n
  1. Select the Environments tab from the left navigation menu.
    2. \n
  2. Select an environment to export.
    3. \n
  3. In the top right corner, select \"Three.
    4. \n
  4. Select Export to download your newly generated JSON file.
    5. \n
\n

Exporting data dumps

\n

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

\n
    \n
  1. \n

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

    \n

    \"Export

    \n
    2. \n
  2. \n

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

    \n
    3. \n
  3. \n

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

    \n
    4. \n
  4. \n

    Select Request Data Export to submit the request.

    \n

    \"Export

    \n
    5. \n
\n

The Export page shows information about your export request, including the file size, the date the export expires, and the statuses of your requested data exports. Possible statuses are:

\n\n

When the export is ready, you will receive an email with link to download a zipped file with the data dump. You can also download the file using the Download button on the Export page.

\n
\n

Data exports from the Scratch Pad are downloaded directly instead of being emailed to you. See Exporting data from the Scratch Pad for more details.

\n
\n

Next steps

\n

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

","frontmatter":{"title":"Importing and exporting data","contextual_links":[{"type":"section","name":"Additional Resources","url":null,"blog_tag":null},{"type":"subtitle","name":"Videos","url":null,"blog_tag":null},{"type":"link","name":"Postman | How to Connect to Your Git Repository","url":"https://youtu.be/8jJHXLVYOh0","blog_tag":null},{"type":"link","name":"Generate a Collection From a Specification | Postman Level Up","url":"https://youtu.be/gljWt9tDKOY","blog_tag":null},{"type":"link","name":"Postman Level Up | Import a HAR file in Postman","url":"https://youtu.be/E3uo-oQ9WtE","blog_tag":null},{"type":"subtitle","name":"Related Blog Posts","url":null,"blog_tag":null},{"type":"link","name":"Sync your specs","url":"https://blog.postman.com/sync-your-specs/","blog_tag":null},{"type":"link","name":"Importing SoapUI projects into Postman","url":"https://blog.postman.com/importing-soapui-projects-into-postman/","blog_tag":null},{"type":"link","name":"Importing RAML folders into Postman","url":"https://blog.postman.com/supporting-raml-folders-in-postman/","blog_tag":null},{"type":"link","name":"Introducing Postman Collection Format Schema","url":"https://blog.postman.com/introducing-postman-collection-format-schema/","blog_tag":null},{"type":"link","name":"Travelogue of Postman Collections Format v2","url":"https://blog.postman.com/travelogue-of-postman-collection-format-v2/","blog_tag":null},{"type":"link","name":"Postman Supports WSDL","url":"https://blog.postman.com/postman-now-supports-wsdl/","blog_tag":null},{"type":"subtitle","name":"Next Steps","url":null,"blog_tag":null},{"type":"link","name":"Using the API Builder","url":"/docs/designing-and-developing-your-api/the-api-workflow/","blog_tag":null}]},"fields":{"slug":"/docs/getting-started/importing-and-exporting-data/","lastModifiedDate":"2022/03/11\n"}}},"pageContext":{"slug":"/docs/getting-started/importing-and-exporting-data/"}}, "staticQueryHashes": ["3840739351","63159454"]}