Collections
Group related requests, organise them in folders, and import what you already have from Postman, OpenAPI, Insomnia or cURL.
A collection is a named group of requests. It is the unit you run, share, document and schedule, so it is worth putting a little thought into how you split them up.
Creating one#
- Open Build → Requests and press New collection.Name it after the thing it covers — a service, or a user journey.
- Add folders if it grows past a screenful.Folders nest one level, which is usually enough. Requests inside them run in order like any other.
- Drag to reorder.Order matters when the collection is run — a request that creates something should come before one that reads it.
Importing what you already have#
- Press Import.Drop a file, paste a URL, or paste a raw cURL command.
- The format is detected for you.Postman collections, OpenAPI specifications, Insomnia exports and cURL are all recognised without being told which is which.
- Check the environment afterwards.Postman variables come across as environment variables, but Postman's collection variables have no exact equivalent — they land in the environment, so look for duplicates.
Importing an OpenAPI specification creates a request per operation, with example bodies filled in from the schema. It is the fastest way to get from a spec to something you can send.
How to split them up#
| Shape | Good for | Watch out for |
|---|---|---|
| One per service | Mirroring how the system is built | Grows large; use folders |
| One per journey | Running as a test — signup, checkout | Duplicates requests across collections |
| One for smoke tests | CI — a handful of critical paths | Keep it short or it stops being run |
Sharing#
- Everyone in the workspace sees the same collections — there is nothing to sync
- Publish it as documentation on a public URL
- Export it back out as a Postman collection or OpenAPI specification
Frequently asked questions#
Can I import a Postman collection?
Yes. Import accepts Postman collection exports (v2 and v2.1) along with OpenAPI, Insomnia and raw cURL, and detects which one you gave it automatically.
Do collections sync between the browser, desktop app and CLI?
They are the same collections — stored in your workspace rather than on a device, so all three see identical content with nothing to sync.