Create Your First Postman Workspace – Complete Beginner's Guide

As you build more APIs, you'll eventually have hundreds of requests, collections, environments, and tests. Managing everything in a single location can quickly become difficult. That's why Postman provides a feature called Workspaces.

A Workspace helps you organize your API development projects by grouping related collections, environments, requests, documentation, and team members into one place.

Throughout this FastAPI course, we'll create a dedicated workspace for all our FastAPI projects so everything remains organized and easy to manage.

In this guide, you'll learn what a Postman Workspace is, why it's useful, how to create one, and how to manage it effectively.

What is a Postman Workspace?

A Postman Workspace is a dedicated area where you organize everything related to an API project.

A workspace can contain:

Collections
API Requests
Environments
Variables
Mock Servers
API Documentation
Team Members (for shared workspaces)

Think of a workspace as a project folder inside Postman.

Why Do We Need a Workspace?

Using a workspace helps you:

Keep API requests organized
Separate different projects
Share APIs with team members
Store environments
Manage collections easily
Improve collaboration
Reduce confusion between projects

For example, you might have separate workspaces for:

FastAPI Course
Personal Projects
Company APIs
Testing
Client Projects

Types of Postman Workspaces

Postman provides several workspace types.

Personal Workspace

Used only by you
Best for learning and personal projects
No collaboration required

Team Workspace

Shared with team members
Supports collaboration
Great for software development teams

Partner Workspace

Shared with external partners
Limited collaboration

Public Workspace

Visible to everyone
Useful for open-source projects and public APIs

Which Workspace Should You Choose?

For this FastAPI course, choose:

code

Personal Workspace

It is simple, free, and perfect for beginners.

Prerequisites

Before creating a workspace, ensure you have:

Postman installed
A Postman account (recommended)
Internet connection

Note: You can use Postman without an account, but creating a free account allows you to save and synchronize your workspaces across devices.

Open Postman

Open the Start Menu.

Search for:

code

Postman

Open the application.

Create a New Workspace

Step 1

On the left sidebar, click:

code

Workspaces

Step 2

Click:

code

Create Workspace

Step 3

Enter the following information.

Workspace Name:

code

FastAPI Course

Description:

code

Workspace for learning and testing FastAPI APIs.

Step 4

Select:

code

Personal

Step 5

Click:

code

Create Workspace

Your new workspace is now ready.

Verify the Workspace

You should now see:

code

FastAPI Course

listed under your workspaces.

Click it.

The workspace dashboard will open.

Understanding the Workspace

Inside your workspace, you'll see several sections.

Collections

Used to organize API requests.

Example:

code

User API

APIs

Used for API specifications and documentation.

Environments

Store variables like:

Base URL
API Key
Access Token
Database URL

History

Displays recently executed requests.

Mock Servers

Create fake APIs before the real backend is completed.

Monitors

Run API tests automatically on a schedule.

Create Your First Collection

Inside the workspace:

Click:

code

New

Select:

code

Collection

Name it:

code

FastAPI Learning

Click:

code

Create

We'll add API requests to this collection throughout the course.

Add Your First Request

Inside the collection:

Click:

code

Add Request

Name it:

code

Home API

Method:

code

GET

URL:

code

http://127.0.0.1:8000/

Save the request.

Later, when your FastAPI application is running, you can test it directly from this request.

Rename a Workspace

If you want to rename your workspace:

Click the three-dot menu beside the workspace name.

Select:

code

Edit Workspace

Update the name and save the changes.

Delete a Workspace

If a workspace is no longer needed:

Click the three-dot menu.

Choose:

code

Delete Workspace

Warning: Deleting a workspace permanently removes its collections and requests unless they are backed up or synchronized with your Postman account.

Common Problems

Cannot Create Workspace

Verify that:

You're connected to the internet.
You're signed in to Postman (if required).
Postman is updated.

Workspace Not Saving

Restart Postman.

If the issue continues, sign in to your Postman account.

Collections Missing

Ensure you're viewing the correct workspace.

Workspace Not Synchronizing

Check your internet connection.

Verify you're signed in with the correct Postman account.

Best Practices

Create one workspace per project.
Use meaningful workspace names.
Store related collections together.
Keep development and production APIs separate.
Back up important collections.
Sync your workspace with your Postman account.

Summary

Congratulations! You have successfully created your first Postman Workspace.

Your workspace is now ready to store API collections, requests, environments, and documentation for your FastAPI projects.

In the next lesson, we will create your first Postman Collection and organize all the API requests we'll build throughout this FastAPI course.

Frequently Asked Questions (FAQs)

What is a Postman Workspace?

A Postman Workspace is a dedicated area where you organize API requests, collections, environments, and other project resources.

Which workspace type should I use?

For this course, use a Personal Workspace.

Can I have multiple workspaces?

Yes. You can create separate workspaces for different projects.

Is a Postman account required?

No. However, a free account allows you to synchronize your workspaces across multiple devices.

Official Download Links

Postman: https://www.postman.com/downloads/
Postman Learning Center: https://learning.postman.com/
Postman Workspaces Documentation: https://learning.postman.com/docs/collaborating-in-postman/using-workspaces/

On this page