Yaak Logo
Yaak
Docs/Migration Guides/Migrate from Postman

Yaak is a fast, offline API client. Keep your requests on your computer, reuse response values without scripts, and share your work through Git. No account required.

You can bring your Postman collections and environments with you. Start with one collection, then follow the team setup below when you’re ready to bring everyone over.

Export from Postman

Start in Postman. You’ll need to export your collections and environments separately.

1. Open the collection menu

Open Collections, click … beside a collection, then choose More โ†’ Export collection.

Postman collection menu with More expanded and Export collection highlighted

Find Export collection under More in the collection menu.

2. Save the collection

Click Export JSON and save the file. If your Postman version offers a format choice, choose Collection v2.1.

Postman Export collection dialog showing the Export JSON button

Click Export JSON to save the collection.

3. Export your environments

Under Environments, click … beside an environment, then choose Export.

Postman environment context menu with Export highlighted

Export each environment your collection uses.

4. Export global variables

If you use global variables, open the Variables pane, select Globals, then Export.

If you’re moving a team, export each collection and environment your team uses. See Postman’s export instructions for bulk export options.

Import into Yaak

Now open Yaak and import your collection file first, followed by any environment files you exported.

Import a sample Postman collection from an empty workspace, then open an imported request. No API requests are sent.

  1. Open Import Data from Yaak’s main menu.
  2. Drop your collection JSON on the dialog, choose the file, or enter its file path or URL.
  3. Choose New Workspace, then Preview Import. Check the detected format and the requests, folders, and variables selected for import.
  4. Click Apply Changes (the button includes the number of changes), then Done.
  5. With the imported workspace active, open Import Data again. Choose your environment JSON and Current Workspace, preview it, then apply the changes.
  6. Select the imported environment in the header. Check your variables and authentication before sending a request.

Template functions let you fetch tokens, generate UUIDs, and more without writing scripts. If you used Postman scripts for these tasks, you can set up template functions after importing. The scripts themselves aren’t imported.

Moving a team

Postman teams sync through Postman’s cloud. In Yaak, you sync through your team’s Git repository.

1. Enable Directory Sync

Only one person needs to import the collections and environments. After importing, enable Directory Sync in Workspace Settings. Choose a folder inside your team’s Git repo.

Directory Sync configured in Workspace Settings

Choose the folder where Yaak will save the workspace files.

2. Enable encryption

Click Enable Encryption in Workspace Settings to encrypt shared secrets. Keep a backup of the workspace key and share it with teammates separately from the repo. See Secrets Encryption for details.

Workspace encryption key with copy and reveal controls

Back up the workspace key so you can recover your encrypted values.

3. Commit and push

Every request, folder, and shared environment becomes a YAML file. Secure values are written encrypted; private environments are never written. Commit these files and push them to your repo.

Review your changes, choose what to include, and commit from Yaak.

4. Invite your teammates

Ask your teammates to clone the repo and open the folder as a workspace, or clone it straight from Yaak. You can review changes through Git commits and pull requests, just like code.

Licenses

Yaak is free for personal use. For work, each person using Yaak needs a license. A Business subscription lets you invite teammates by email and reassign seats from one dashboard. Managing billing doesn’t use a seat unless you also activate a license.

See Team License Management to get your team set up. For invoicing or SSO, contact sales.

Was this helpful?

Loading...