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.
You can also import items by dragging and dropping files or folders into Postman.
You can import data that was exported from Postman, including collections, environments, data dumps, and globals. Postman will automatically recognize Postman data on import.
Select Import in the sidebar.
Do one of the following:
If you're importing multiple files, select the files you want to import, then select Import.
If you are importing a single file, Postman imports it after you select it.
An Import Complete message displays in the footer. In the message, select the link icon next to a collection or environment to open the imported element.
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:
In the terminal of your choice, enter the following command to install the Postman Collection Transformer.
sudo npm install -g postman-collection-transformer
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.
Postman can import requests, environments, and other data from the following API clients:
To learn more about using cURL commands to import data, go to Import cURL commands.
To learn more about importing your API definitions into Postman, go to Import an API into Postman.
Last modified: 2023/10/18
Additional resources
Videos
Blog posts