Importing and exporting collections in Postman

Introduction

Importing and exporting collections helps you save and share your API tests easily. It keeps your work safe and lets others use your tests.

You want to back up your API tests before making big changes.

You need to share your API tests with a teammate or client.

You want to move your tests from one computer to another.

You want to use a collection someone else created.

You want to keep a version history of your API tests.

Syntax

Postman

Import Collection:
1. Click 'Import' button in Postman.
2. Choose file or paste raw text.
3. Click 'Import' to add collection.

Export Collection:
1. Select collection in Postman.
2. Click '...' (three dots) next to collection name.
3. Choose 'Export'.
4. Select export format (e.g., v2.1).
5. Save the file to your computer.

Collections are saved as JSON files.

Use the latest export format for best compatibility.

Examples

This adds the collection from the file to your Postman workspace.

Postman

Importing a collection from a file:
- Click 'Import'
- Select 'Upload Files'
- Choose 'my_api_tests.json'
- Click 'Import'

This saves your collection so you can share or back it up.

Postman

Exporting a collection:
- Click '...' next to collection
- Select 'Export'
- Choose 'Collection v2.1'
- Save as 'backup_tests.json'

Sample Program

This step-by-step shows how to import a collection file and then export it again to save or share.

Postman

1. Open Postman.
2. Click 'Import'.
3. Upload 'example_collection.json'.
4. Confirm collection appears in workspace.
5. Click '...' next to collection.
6. Select 'Export'.
7. Choose 'Collection v2.1'.
8. Save file as 'exported_collection.json'.

Important Notes

Always check the collection version when importing to avoid errors.

Exported collections can be edited as JSON if needed, but be careful not to break the format.

Use descriptive names for exported files to keep track easily.

Summary

Importing collections lets you add existing API tests to Postman.

Exporting collections saves your tests for sharing or backup.

Both actions use JSON files and are simple to do with Postman's buttons.

Practice

1. What is the main purpose of importing a collection in Postman?

easy

A. To add existing API tests into Postman for use

B. To delete all current tests in Postman

C. To export tests to a JSON file

D. To create a new API from scratch

Solution

1. Step 1: Understand importing collections

   Importing collections means bringing existing API tests into Postman so you can use or modify them.

2. Step 2: Differentiate from exporting and creating

   Exporting saves tests out of Postman, and creating new APIs is different from importing.

3. Final Answer:

   To add existing API tests into Postman for use -> Option A

4. Quick Check:

   Import = Add existing tests [OK]

Hint: Import means bringing tests in, not creating or deleting [OK]

Common Mistakes:

• Confusing import with export
• Thinking import deletes tests
• Assuming import creates new APIs

2. Which file format is used when exporting a collection from Postman?

easy

A. .xml

B. .csv

C. .json

D. .txt

Solution

1. Step 1: Identify export file format

   Postman exports collections as JSON files, which store structured data about API tests.

2. Step 2: Exclude other formats

   XML, TXT, and CSV are not used by Postman for exporting collections.

3. Final Answer:

   .json -> Option C

4. Quick Check:

   Exported collections use JSON files [OK]

Hint: Postman collections export as JSON files only [OK]

Common Mistakes:

• Choosing XML or CSV instead of JSON
• Confusing export format with import options
• Assuming text files are used

3. You exported a collection from Postman and shared the JSON file. Your teammate imports it but sees no requests. What is the likely cause?

medium

A. Postman does not support importing JSON files

B. The JSON file was empty or corrupted

C. The teammate did not restart Postman after import

D. The collection was exported in XML format

Solution

1. Step 1: Check file integrity

   If the imported collection shows no requests, the JSON file might be empty or corrupted, causing no data to load.

2. Step 2: Verify import support and format

   Postman supports JSON imports, and restarting is not required. Exporting in XML is not possible, so that is invalid.

3. Final Answer:

   The JSON file was empty or corrupted -> Option B

4. Quick Check:

   Empty/corrupt JSON causes no requests on import [OK]

Hint: Empty or broken JSON files cause empty imports [OK]

Common Mistakes:

• Thinking Postman can't import JSON
• Assuming restart is needed after import
• Believing XML export is possible

4. You tried to export a collection but the export button is disabled. What should you check to fix this?

medium

A. Ensure a collection is selected in Postman

B. Restart your computer immediately

C. Change the export file format to XML

D. Uninstall and reinstall Postman

Solution

1. Step 1: Verify collection selection

   The export button is disabled if no collection is selected. Selecting a collection enables export.

2. Step 2: Exclude unnecessary actions

   Restarting, changing to XML (unsupported), or reinstalling are not needed to enable export.

3. Final Answer:

   Ensure a collection is selected in Postman -> Option A

4. Quick Check:

   Export button needs a selected collection [OK]

Hint: Select a collection first to enable export button [OK]

Common Mistakes:

• Trying unsupported XML format
• Restarting unnecessarily
• Reinstalling Postman without checking selection

5. You want to share a set of API tests with a teammate who uses Postman. Which steps correctly describe exporting and importing the collection?

hard

A. Copy the collection URL, teammate pastes it in browser to import

B. Export the collection as CSV, send the file, teammate imports CSV in Postman

C. Export the collection as XML, send the file, teammate imports XML in Postman

D. Export the collection as JSON, send the file, teammate imports JSON in Postman

Solution

1. Step 1: Export collection as JSON

   Postman exports collections only as JSON files for sharing or backup.

2. Step 2: Teammate imports JSON file

   The teammate imports the JSON file into their Postman app to get the same tests.

3. Final Answer:

   Export the collection as JSON, send the file, teammate imports JSON in Postman -> Option D

4. Quick Check:

   Export and import use JSON files [OK]

Hint: Always export/import collections as JSON files [OK]

Common Mistakes:

• Using CSV or XML formats
• Thinking URL copy imports collections
• Skipping export step