Import from Postman

Video Tutorial

Conceptual Mapping

Understanding the conceptual correlation between Postman and Apidog can help prevent data inconsistencies during import.

In Postman, a Collection corresponds to a Project in Apidog. Thus, variables within a Postman Collection are equivalent to global variables in an Apidog project.

The Postman API uses variables to store the front URL (usually a domain name), while the front URL of Apidog is stored independently in the Service in Environment Management.

Example

Suppose you have a Collection named Apidog Echo, which contains two variables:

baseUrl: defines the service address

name: used as a query parameter

This Collection has a GET request:

Now it's time to export the Collection and import it into Apidog.
If you already have a Collection in Postman, feel free to use that instead — no need to start from scratch.

How to Export Data from Postman?

Exporting a Collection

Follow these steps to export a collection from Postman:

Open Collections on the left sidebar of Postman

Mouse over the collection to export, click the ... icon, and select Export

In the pop-up window, choose the export format as Collection v2.1.

Click Export, then save the file to your computer as a .json file.

Exporting an Environment (Optional)

Open the Environments tab from the left sidebar.

Locate the environment you want to export, click ···, then select Export.

Save the environment as a .json file.

Exporting Workspace Data (Data Dump) – Optional

Postman also offers a Data Dump feature to export your entire workspace. This includes all your Collections, Environments, and Global variables in one .json file.

Here’s how:

Select your avatar in the Postman header, then select Settings.

Select the Account tab.

Select Export Data, then select the data types you want to export (like collections, environments,etc.)

Select Request Data Export.

When the export is ready, you'll get an email with a link to download the bulk data file. The download will be available for two days, after which it expires.

Note

Data Dumps are mainly used for backups and internal Postman recovery. They’re not recommended for migrating to Apidog. For best results, export Collections and Environments individually.

How to Import Postman Data into Apidog?

Importing a Collection

Open the Project Settings panel in Apidog, click Import Data, select Postman, and upload your file.

You can view all the endpoints under the Collection on the import preview page. To seamlessly migrate, you need to check the environment with the same name as the Collection on the Environment tab, and then click the Confirm button.

After the importing process is completed, you can see the name parameter on the API documentation and the link address in baseUrl in Environment Management section.

When debugging an endpoint, select the corresponding environment. The prefix URL will automatically be appended to the path, just like in Postman.

Importing an Environment (Optional)

In Apidog, go to your Project Settings → Import Data.

Choose Postman, then upload the exported Postman Environment .json file.

After importing, you can switch to the corresponding environment during endpoint debugging.

Importing Workspace Data/Data Dumps (Optional)

In Apidog, go to your Project Settings → Import Data.

Choose Postman, then upload the extracted files or folders.

After importing, you can switch to the corresponding environment during endpoint debugging. (Currently, Collection only supports selecting one.)

Using Data Dump for data migration is currently not recommended. Instead, we suggest importing the following separately:

Collection: Corresponds to the project and endpoint structure in Apidog

Environment: Corresponds to the environment configuration in Apidog

For a more detailed guide, check out this best practice article: How to Migrate Postman Collections/Environments to Apidog

Video Tutorial#

Conceptual Mapping#

Example#

How to Export Data from Postman?#

Exporting a Collection#

Exporting an Environment (Optional)#

Exporting Workspace Data (Data Dump) – Optional#

How to Import Postman Data into Apidog?#

Importing a Collection#

Importing an Environment (Optional)#

Importing Workspace Data/Data Dumps (Optional)#

Video Tutorial

Conceptual Mapping

Example

How to Export Data from Postman?

Exporting a Collection

Exporting an Environment (Optional)

Exporting Workspace Data (Data Dump) – Optional

How to Import Postman Data into Apidog?

Importing a Collection

Importing an Environment (Optional)

Importing Workspace Data/Data Dumps (Optional)