Migrate from Insomnia

Moving from Insomnia to Yaak? This guide covers how to export your Insomnia data and import it into Yaak with minimal friction.

What Gets Imported

Yaak supports Insomnia export formats v4 and v5. When you import from Insomnia, Yaak converts:

• HTTP requests — URLs, methods, headers, query parameters, and body content
• gRPC requests — Including service and method from proto definitions
• WebSocket requests — URL, headers, and message content (v5 only)
• Request groups — Folder structure is preserved
• Environments — Base and sub-environments with all variables
• Authentication — Bearer tokens and basic auth configurations
• Body types — JSON, form-urlencoded, multipart/form-data, GraphQL, and binary files
• Template syntax — Insomnia’s {{ variable }} syntax is converted to Yaak’s ${[variable]} syntax

Export from Insomnia

To export your Insomnia workspace:

1. Open Insomnia and select the workspace you want to export
2. Click the workspace dropdown menu
3. Select Import/Export → Export Data
4. Choose Current Workspace or All Workspaces
5. Select Insomnia v4 (JSON) or YAML format
6. Save the file to your computer

Import into Yaak

1. Open Yaak and go to Settings (gear icon) → Import/Export
2. Click Import
3. Select your exported Insomnia JSON or YAML file
4. Yaak will create workspaces matching your Insomnia structure

After Import

Once your data is imported:

• Check environments — Verify your environment variables transferred correctly
• Review authentication — Bearer and basic auth should import, other types may need manual setup
• Test requests — Send a few requests to confirm everything works
• Set up Git sync — Use directory sync to version control your workspace

Need Help?

Having trouble with your import? Check our troubleshooting guide or open an issue on GitHub.