---
title: "Working across multiple workspaces"
description: "How one Linkbreakers account belongs to several workspaces: creating a new workspace, the Free workspace limit, joining by invitation, the workspace switcher, per-workspace roles and sessions, MFA when switching, MCP clients, API tokens and what happens when you are removed."
canonical: "https://linkbreakers.com/help/article/work-across-multiple-workspaces"
last-updated: 2026-10-30
---

# Working across multiple workspaces

> How one Linkbreakers account belongs to several workspaces: creating a new workspace, the Free workspace limit, joining by invitation, the workspace switcher, per-workspace roles and sessions, MFA when switching, MCP clients, API tokens and what happens when you are removed.

## Short answer

One Linkbreakers account, identified by your email address, can belong to several workspaces. You create a new one from the workspace switcher at the top right of the dashboard with **New workspace**: it starts on the Free plan, with you as Admin, and is billed separately. You join someone else's workspace when one of its admins invites the email you already use: you are added right away and receive a "You've been added to" email, followed by the workspace name, whose link opens that workspace. The switcher lists every workspace you belong to. Your role, your session and any MFA requirement are set per workspace, while your password and sign-in methods belong to your account and apply everywhere.

## Quick summary

- One account, one email, any number of workspaces you created or were invited to
- **New workspace** in the switcher creates a workspace on the Free plan, with you as Admin, and opens it
- Every workspace has its own plan, platform credits, allowances, team, custom domains and billing
- You can found up to 2 Free workspaces, counting the one created at sign-up; paid workspaces and workspaces you were invited to do not count
- To join someone else's workspace, an admin of that workspace invites your existing email
- An invitation to an email that already has an account adds you immediately, with no acceptance step
- Password, Google or Microsoft sign-in and email verification belong to your account, so they apply to every workspace
- The switcher at the top right of the dashboard lists your workspaces and your role in each; it appears for every account with an email address
- Signing in opens the last workspace you used
- A workspace that enforces MFA asks for an emailed 6-digit code when you switch into it
- Each workspace keeps its own session, and your [role](/help/article/what-are-the-workspace-roles-in-linkbreakers) is set per workspace
- MCP clients act in one workspace, chosen on the OAuth consent screen
- API tokens belong to one workspace and are not affected

## What belongs to your account and what belongs to a workspace

| Setting | Belongs to | What that means |
| --- | --- | --- |
| Email address | Account | The same email identifies you in every workspace |
| Password | Account | A password change or reset applies to every workspace |
| Google or Microsoft sign-in | Account | Works for every workspace you belong to |
| Email verification | Account | Verify once, valid everywhere |
| Plan, platform credits and allowances | Workspace | Each workspace is billed separately |
| Custom domains | Workspace | A domain belongs to one workspace |
| Role (Admin, Viewer, Tech) | Workspace | You can be Admin in one workspace and Viewer in another |
| Session | Workspace | Switching does not sign you out of the others |
| MFA requirement | Workspace | Set by each workspace's admins |
| API tokens | Workspace | A token only ever acts in the workspace that issued it |
| Links, QR codes, visitors, analytics | Workspace | Nothing is shared between workspaces |

## Create a new workspace

Anyone whose account has an email address can create a workspace from the switcher.

1. Open the workspace switcher at the top right of the dashboard (on mobile, in the profile drawer)
2. Pick **New workspace**, the last item in the list
3. Give the workspace a name

Linkbreakers creates it on the Free plan, makes you its Admin and opens it straight away. Like a switch, this keeps your other workspaces signed in. If your email address is already verified, the new workspace does not need verifying again.

A new workspace shares nothing with your others. It has its own plan, platform credits, allowances, team, custom domains and billing, so an agency or a business with several brands can keep each client or brand fully separate, each on its own plan. To choose between a workspace per client and one workspace with a directory per client, see [How to keep QR codes and analytics separate for multiple clients](/help/article/how-to-manage-qr-codes-for-multiple-clients).

### The Free workspace limit

You can found at most 2 Free workspaces, and the one created when you signed up counts as one of them. These never count toward the limit:

- Workspaces you were invited to
- Workspaces on a paid plan (Light, Pro or Enterprise), a trial or a sponsored plan

When you reach the limit, the dashboard says "You already created 2 Free workspaces. Upgrade one of them to a paid plan to create another." Upgrade one of your Free workspaces to a paid plan, then create the new one. As long as the others are paid, there is no limit on how many workspaces you create. Invitations are not affected and stay unlimited.

## How you join another workspace

You get access to someone else's workspace when one of its admins [invites you](/help/article/how-to-invite-team-members-to-linkbreakers) using the email address your account already uses.

1. The admin invites your email from **Team Members** in their workspace
2. Because that email already has a Linkbreakers account, you are added to the workspace immediately, with the role the admin picked
3. You receive an email titled "You've been added to" followed by the workspace name
4. The link in that email opens that workspace directly. If your browser is signed in to a different Linkbreakers account, it signs you out and shows the sign-in form first, so you land in the workspace with the right account

If the admin invites a different email address, such as a personal one, that invitation creates a separate account instead. Ask for the invitation to go to the email you already sign in with if you want one account for all your workspaces.

## Switch between workspaces

The workspace switcher sits at the top right of the dashboard and shows the workspace you are in. Open it to see every workspace you belong to, with your role in each, and pick one to switch.

- The switcher appears for every account with an email address, even with a single workspace, so **New workspace** is always within reach
- On mobile, the same list is in the profile drawer
- When you sign in, Linkbreakers opens the last workspace you used

Each workspace keeps its own session. Switching to another workspace does not sign you out of the ones you left, so switching back is immediate unless that session has expired.

## MFA when you switch

MFA is enforced per workspace. When you switch into a workspace whose admins have [enabled MFA](/help/article/how-do-you-activate-mfa-in-linkbreakers), Linkbreakers sends a 6-digit code to your email and asks for it before opening the workspace.

- The code is valid for 15 minutes
- You can ask for a new code after 30 seconds
- Workspaces without MFA open without a code, even if another of your workspaces enforces it

## AI assistants and MCP clients

Claude, ChatGPT, Cursor and other MCP clients connect through the [Linkbreakers MCP server](/help/article/mcp-server-setup) with OAuth. If you belong to several workspaces, the OAuth consent screen asks which workspace the client should use.

- The client acts in that one workspace, with the role you hold there
- To use another workspace from the same client, authorize it again and pick the other workspace
- If the chosen workspace enforces MFA, the consent screen asks for the emailed 6-digit code, with at most 8 attempts per authorization

To limit what a client can do beyond your role, request [API token scopes](/help/article/api-token-scopes) during authorization. See [How Linkbreakers works with AI agents](/help/article/linkbreakers-for-ai-agents) for every way an agent can connect.

## API tokens and the API

[API tokens](/help/article/what-are-api-tokens) belong to the workspace that created them. Belonging to several workspaces does not change what an existing token can reach, and a token never acts in another workspace.

For developers building on a member's dashboard session, three endpoints in the [Workspaces API reference](/help/api/workspaces) cover multiple workspaces:

- `GET /v1/myself/workspaces` lists the workspaces the signed-in member belongs to, with their role in each
- `POST /v1/myself/workspaces/{workspaceId}:switch` switches the session to another workspace
- `POST /v1/myself/workspaces` with a body such as `{"name": "Acme Coffee"}` creates a workspace and returns `accessToken`, `memberId`, `workspaceId` and `member` for it, the same shape as switching

Creating a workspace needs a dashboard session, or a full-access member token belonging to a person with an email address. Workspace API tokens and tokens limited to scopes are refused. Past the Free workspace limit, the call answers `400` with the code `FREE_WORKSPACE_LIMIT_REACHED` and the limit in `metadata.limit`. Because it issues a new access token, creating a workspace is not available as an MCP tool.

## For admins: removing members and deleting workspaces

- **Removing a member** removes them from your workspace only. Their account and their other workspaces stay as they are
- **Deleting a workspace** removes that workspace. Its members keep their accounts and every other workspace they belong to

## Limits and caveats

- You can found at most 2 Free workspaces, counting the one created at sign-up; upgrade one to a paid plan to create another
- Each workspace is billed separately; plans, credits and allowances are never pooled across workspaces
- Creating a workspace through the API needs a dashboard session or a full-access member token, and is not an MCP tool
- An invitation to a different email address creates a separate account, which does not share the switcher
- An MCP client is authorized for one workspace at a time
- Team member limits depend on the plan of each workspace, not on your account

## Frequently asked questions

### Can I create a new workspace from my existing account?

Yes. Open the workspace switcher and pick **New workspace**. The workspace starts on the Free plan with you as Admin, and is billed separately from your other workspaces.

### How many workspaces can I create?

Up to 2 Free workspaces, counting the one created at sign-up. Workspaces on a paid plan, a trial or a sponsored plan do not count, and neither do workspaces you were invited to, so upgrading one of your Free workspaces lets you create another.

### Do I need a different password for each workspace?

No. Your password belongs to your account. Changing or resetting it applies to every workspace you belong to, and so does Google or Microsoft sign-in.

### Why don't I see the workspace switcher?

The switcher appears for every account with an email address, at the top right of the dashboard or in the profile drawer on mobile. If you were invited under a different email address, that invitation created a separate account, and its workspace appears in that account's switcher instead.

### Does switching workspaces sign me out?

No. Each workspace keeps its own session, so the workspaces you leave stay signed in.

### Why am I asked for a code when I switch?

That workspace enforces MFA. Enter the 6-digit code sent to your email. It is valid for 15 minutes, and you can request a new one after 30 seconds.

### Can my AI assistant work in two workspaces?

An MCP client works in the workspace you picked on the consent screen. To use another workspace, authorize the client again and choose that workspace.

### What happens to my account if I am removed from a workspace?

Nothing else changes. You lose access to that workspace only, and keep your account and your other workspaces.

## Sources

- [How to invite team members to Linkbreakers](/help/article/how-to-invite-team-members-to-linkbreakers)
- [What are the workspace roles in Linkbreakers](/help/article/what-are-the-workspace-roles-in-linkbreakers)
- [Workspaces API reference](/help/api/workspaces)
- [Create a new workspace from the switcher](/help/article/create-a-new-workspace)

## Last reviewed

2026-10-28