> ## Documentation Index
> Fetch the complete documentation index at: https://docs.requestly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Import from postman

> Learn how to migrate your Postman collections and environment variables to Requestly.

***

Postman is a popular API development tool widely used for testing and managing APIs. Requestly can import collections and environment files exported from Postman.

[https://www.youtube.com/embed/7jXGYMj9izw](https://www.youtube.com/embed/7jXGYMj9izw)

### **Export all the workspace data from Postman**

**Step 1**: Click your profile icon in the top-right corner of Postman and select **Settings**.

![](https://mintcdn.com/requestly/kJ2YgeAVYHOUrgCk/images/import-from-postman/d59ffe07-f75e-48b5-b14c-5118125a9e67.png?fit=max\&auto=format\&n=kJ2YgeAVYHOUrgCk\&q=85\&s=195cd7c65dc520815cc49de40e49b121)

**Step 2**: Navigate to the **Account** tab and click **Export Data**. It will redirect you to Export data page. Click on **Export data** button.

![](https://mintcdn.com/requestly/kJ2YgeAVYHOUrgCk/images/import-from-postman/70ae35a8-27b1-4364-ac90-1b5df84c84ff.png?fit=max\&auto=format\&n=kJ2YgeAVYHOUrgCk\&q=85\&s=2e683c76a17e69d19eb011644dc679a1)

**Step 3**: Select the data to export (collections, environments, or both) and click **Request Data Export**.

![](https://mintcdn.com/requestly/kJ2YgeAVYHOUrgCk/images/import-from-postman/943ec5e3-aff4-4923-a504-a787906a4be5.png?fit=max\&auto=format\&n=kJ2YgeAVYHOUrgCk\&q=85\&s=36fdd6f8e4717072b85193da7db37959)

**Step 4**: Check your registered email for exported data, download the ZIP file and extract its contents.

You can also export individual collections and environments from Postman, as explained at the end of this documentation.

Global variables are not automatically exported using this method.\
To use them in Requestly, you need to manually export global variables from Postman and import it into Requestly.

### **Importing into Requestly**

**Step 1**: Open **Requestly Desktop App**.

**Step 2**: Click the **Import** button located in the sidebar header and choose **Postman** from the import options.

![](https://mintcdn.com/requestly/kJ2YgeAVYHOUrgCk/images/import-from-postman/11bb225d-e951-42cb-a760-185f92fe99f9.png?fit=max\&auto=format\&n=kJ2YgeAVYHOUrgCk\&q=85\&s=c7937ccf2c374aef0006f45a4c717711)

**Step 3**: In the upload modal, select and upload the exported Postman **collection** and **environment** files(Multiple files can be imported at once).

![](https://mintcdn.com/requestly/kJ2YgeAVYHOUrgCk/images/import-from-postman/2d2c2344-ea8f-464a-89b9-fe4323dc53ae.png?fit=max\&auto=format\&n=kJ2YgeAVYHOUrgCk\&q=85\&s=4b0da4c1acd94f3ca333b6bc955e8129)

**Step 4**: Once the files are processed, click **Import** to finalize the migration.

![](https://mintcdn.com/requestly/kJ2YgeAVYHOUrgCk/images/import-from-postman/b325343a-9d36-4b01-a9a8-307607ce4720.png?fit=max\&auto=format\&n=kJ2YgeAVYHOUrgCk\&q=85\&s=8675126ecb24cd6caae890e21a60479e)

### **Exporting individual Collections from Postman**

**Step 1**: Open Postman and navigate to the **Collections** tab in the left sidebar to view your collections.

![](https://mintcdn.com/requestly/kJ2YgeAVYHOUrgCk/images/import-from-postman/8545b3a7-ac94-4669-b9cc-4702e31961de.png?fit=max\&auto=format\&n=kJ2YgeAVYHOUrgCk\&q=85\&s=cbc80470e645dcb74589431ae0cb306b)

**Step 2**: Click the ellipsis (`...`) next to the collection you wish to export and select **Export** from the dropdown menu.

**Step 3**: In the export dialog, select either **Collection v2** or **Collection v2.1**(Requestly supports both) as the export format. Click **Export** and save the file.

![](https://mintcdn.com/requestly/kJ2YgeAVYHOUrgCk/images/import-from-postman/378a8db4-9de3-4ebd-b0ed-e91ba40ae841.png?fit=max\&auto=format\&n=kJ2YgeAVYHOUrgCk\&q=85\&s=526739468b7a13541efaf9b0e08d8a8d)

**Step 4**: Import using the same steps as explained in **Import into Requestly** section above.

### **Exporting individual Environments from Postman**

**Step 1**: Open Postman and go to the **Environments** tab in the left sidebar to view your environments.

![](https://mintcdn.com/requestly/kJ2YgeAVYHOUrgCk/images/import-from-postman/5e139394-7c92-4384-94b3-5dd3e0f6f0bd.png?fit=max\&auto=format\&n=kJ2YgeAVYHOUrgCk\&q=85\&s=53228ba11b659f1378c93d4f746a48fe)

**Step 2**: Click the ellipsis (`...`) next to the environment you wish to export and select **Export**.

**Step 3**: Choose a location to save the exported environment file and click **Save**.

![](https://mintcdn.com/requestly/kJ2YgeAVYHOUrgCk/images/import-from-postman/e438749a-2a63-4a64-9441-a7f24adf3a02.png?fit=max\&auto=format\&n=kJ2YgeAVYHOUrgCk\&q=85\&s=b3054d218f34536bc2e442a5b07a95c6)

**Step 4**: Import using the same steps as explained in **Import into Requestly** section above.

### **Known Limitations**

Postman's export format does not include everything in your Postman workspace. Be aware of these gaps before migrating:

* **gRPC collections are not exported.** Postman does not include gRPC requests in its collection export files. There is no workaround - gRPC requests must be recreated manually in Requestly.

* **WebSocket requests are not exported.** Similar to gRPC, Postman does not include WebSocket requests in exported collections.

* **Global variables require a separate export.** Postman's bulk data export does not include global variables. You need to export them manually from the Postman **Environments** sidebar (click the **Globals** entry, then **Export**) and import the resulting file into Requestly alongside your collections.

* **Secret variable values are exported in plaintext.** Postman does not encrypt secret variables in exported files. Review your exported files before sharing them.

* **Binary body and file references are not preserved.** Requests with binary file bodies or form-data file attachments lose the file reference on export. You will need to re-attach files manually after importing into Requestly.

* **Scripts are translated to `rq.*`.** The importer renames `pm.*` to `rq.*` automatically. `pm.vault` calls translate to [`rq.vault`](https://docs.requestly.com/api-client/rq-api-reference/rq-vault). `pm.cookies` and `pm.cookies.jar()` work through `rq.cookies`, and the jar can be used only for hosts on the Cookie manager's [Domains allowlist](https://docs.requestly.com/api-client/send-api-request/cookies.md#allow-scripts-to-read-cookies). Request mutation from pre-request scripts works as it does in Postman: headers, query parameters, the URL, the method, and the body (`pm.request.body.update()`) all change the request that is sent. Scripts that read or change the request's auth (`pm.request.auth`, `pm.request.authorizeUsing()`) and the rest of `pm.request`'s members work as they do in Postman; see [rq.request](https://docs.requestly.com/api-client/rq-api-reference/rq-request.md#properties-and-methods). Response visualizations are supported: `pm.visualizer` scripts are translated to [`rq.visualizer`](https://docs.requestly.com/api-client/rq-api-reference/rq-visualizer) and run without changes.

* **Only the two root names change.** `pm` becomes `rq` and `postman` becomes `requestly`. The older global variables (`request`, `responseBody`, `environment`, `globals`, `data`, `tests`, and the others) and the `postman.*` members are not rewritten. They keep working as they do in Postman. An object or function among them, such as `request`, `environment`, `globals`, `tests` or a `postman.*` member, shows a deprecation warning that names the `rq.*` replacement the first time a script uses it. Reading a plain value such as `responseBody`, `responseTime` or `iteration` does not warn. See [Legacy globals and requestly](https://docs.requestly.com/api-client/rq-api-reference/legacy-globals.md). `tv4`, `Backbone` and `cheerio` are [built-in libraries](https://docs.requestly.com/api-client/import-packages-into-your-scripts.md#supported-libraries) and need no installation.

* **Collection-level scripts may need review.** Collection-level pre-request and test scripts are imported, but differences between the Postman and Requestly scripting runtimes may require adjustments.

* **External script references are skipped.** Scripts that reference external URLs (instead of inline code) cannot be imported. Inline the script code before exporting from Postman.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.