Migrate from Postman

Switching from Postman to Yaak? This guide walks you through importing your Postman collections, environments, and getting up and running quickly.

What Gets Imported

Yaak supports importing Postman Collection v2.0 and v2.1 formats. When you import a Postman collection, Yaak converts:

• Requests — HTTP methods, URLs, headers, query parameters, and body content
• Folders — Collection folder structure is preserved
• Variables — Collection variables become a “Global Variables” environment in Yaak
• Authentication — Basic auth, bearer tokens, API keys, AWS Signature v4, JWT, and OAuth 2.0 (including PKCE)
• Body types — JSON, form-urlencoded, multipart/form-data, GraphQL, raw text, and binary files
• Template syntax — Postman’s {{variable}} syntax is converted to Yaak’s ${[variable]} syntax

Export from Postman

First, export your collection from Postman:

1. Open Postman and select the collection you want to export
2. Click the three dots (…) next to the collection name
3. Select Export
4. Choose Collection v2.1 format (recommended)
5. Save the JSON file to your computer

Exporting Environments

Postman environments must be exported separately:

1. Click the Environments tab in Postman
2. Click the three dots next to the environment you want to export
3. Select Export and save the JSON file

You can then import the environment file into Yaak using the same import flow—it will be added to your current workspace.

Import into Yaak

1. Open Yaak and go to Settings (gear icon) → Import/Export
2. Click Import
3. Select your exported Postman collection JSON file
4. Yaak will create a new workspace with your imported requests

After Import

After importing, you may want to:

• Import environments — If you exported Postman environments, import them into the same workspace
• Check authentication — OAuth 2.0 configurations should transfer, but you may need to re-authenticate
• Test requests — Run a few requests to verify everything works as expected
• Enable Git sync — Use Yaak’s directory sync to version control your workspace

Need Help?

If you run into issues importing your Postman data, check out our troubleshooting guide or reach out through GitHub Issues.