Let's get Postman installed and set up. This takes about 5 minutes. By the end, you'll have a workspace ready for all the exercises in this chapter.
Go to https://www.postman.com/downloads/ — pick your OS (Windows, Mac, or Linux)
Download the installer and run it. On Mac, drag to Applications. On Windows, run the .exe.
Launch Postman. You'll see a signup screen.
Create a free account with your email or Google/GitHub login. You can also click "Skip and go to the app" to use Scratch Pad (offline mode, no sync).
Once inside, you're on the home screen. That's it — you're ready.
Always use the desktop app, not the web version. The desktop app can hit localhost URLs, handle cookies properly, and work with SSL certificates. The web version has limitations that will frustrate you later.
Workspaces in Postman are like projects. Each workspace has its own collections, environments, and history. Keep things organized from day one.
Click "Workspaces" in the top-left
Click "Create Workspace"
Name it "API Testing Practice"
Set visibility to "Personal" (only you can see it)
Click "Create Workspace"
Before you send your first request, let's understand the Postman interface. Think of it like a cockpit — every panel has a purpose.
| Panel | What You'll Use It For | How Often |
|---|---|---|
| Sidebar > Collections | Organize and access saved requests | Every session |
| Sidebar > Environments | Switch between dev/staging/prod URLs | Daily |
| Sidebar > History | Find a request you sent yesterday | When you forget to save |
| Request > Params tab | Add query parameters visually | Frequently |
| Request > Headers tab | Set Content-Type, Authorization | Every request |
| Request > Body tab | Write JSON for POST/PUT/PATCH | For write operations |
| Response > Body | Read the API response | Every request |
| Bottom > Console | Debug scripts, see raw traffic | When things break |
Press Ctrl+/ (Cmd+/ on Mac) to see all keyboard shortcuts. The most useful: Ctrl+Enter to send a request, Ctrl+S to save, Ctrl+N for a new request tab. Learn these three and you'll be 2x faster.
Key Point: Sidebar = your saved work. Request panel = what you send. Response panel = what you get back. Console = your debugger. That's the entire Postman UI.
Key Point: Install the desktop app, create an account, set up a workspace. Know the four panels: sidebar, request, response, console.