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

To import your data into Postman, clickImport 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.

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

Import Postman data

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

For Postman Free plans, you can only import a maximum of five collections per minute if each collection is greater than 500 KB in size. If you encounter this limit, you can continue to import collections that are each less than 500 KB in size.

1. ClickImport 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 aboutexporting and importing data dumps.

   • Paste your raw text or URL into the box.

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

     You can import data from aGitHub, Bitbucket, GitLab, or Azure code repository. You can also import an API fromAWS API Gateway orAzure API Management, or import data fromNew Relic.

3. If you’re importing multiple files, select the files you want to import, then clickImport.

   

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

4. AnImport Complete message displays in the footer. In the message, clickGo to Collection next to a collection or environment to open the imported element.

   

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 your terminal, enter the following command to install the Postman Collection Transformer.

   sudonpminstall-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>-j1.0.0-p2.0.0-P

The resulting collection is written to your target file path in v2 format.

You can retrieve a list ofconvert options by running the command with the-h option:

postman-collection-transformer convert-h

Go to thePostman 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:

• SoapUI
• Hoppscotch
• Insomnia
• Thunder Client

Import from cURL commands

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

Import API definitions

Learn more aboutimporting your API definitions into the Postman API Builder. You can also learn aboutimporting your API specifications in OpenAPI 3.0 or AsyncAPI 2.0 format into Spec Hub.

• On this page

• Import Postman data
• Migrate from other API Clients
• Import from cURL commands
• Import API definitions