> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kordless.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create or switch workspaces

> Enter the correct direct workspace through Clerk's OrganizationSwitcher without confusing it with Accounts.

Enter the correct directly operated workspace without confusing it with Accounts.

## What is a workspace?

A **workspace** is the directly operated business selected through the active Clerk Organization. One Clerk Organization is one directly operated workspace. You cannot add a second directly owned business inside an existing workspace — you create or join another Organization through Clerk.

A **connected Account** is a third-party business your workspace may view, integrate, or manage. Connected Accounts appear in the Accounts capability, not in the OrganizationSwitcher. They are not the same thing.

## Before you start

* A Kordless account (sign up at [hq.kordless.ai](https://hq.kordless.ai))
* Membership in at least one Clerk Organization, or an invitation to one

## Create a new workspace

<Steps>
  <Step title="Open the OrganizationSwitcher">
    On desktop, the OrganizationSwitcher is at the foot of the sidebar. On mobile, find it in the More sheet under your account.

    Click or tap the current organization name to open the switcher.
  </Step>

  <Step title="Choose Create organization">
    The switcher opens a modal. Select **Create organization**. Type the business name. The name becomes the Organization name and the workspace URL slug.

    Clerk creates the Organization and sets it active. Kordless provisions the workspace idempotently — if the transaction is interrupted, retrying converges without creating a duplicate.
  </Step>

  <Step title="Land in the new workspace">
    After creation, Kordless redirects you to the new workspace's Book in Test mode. The welcome screen handles naming and currency selection in one step if this is your first Organization.
  </Step>
</Steps>

## Switch to an existing workspace

<Steps>
  <Step title="Open the OrganizationSwitcher">
    Use the same control at the sidebar foot (desktop) or in the More sheet (mobile).
  </Step>

  <Step title="Select the Organization">
    The switcher lists every Organization you belong to. Select one to make it active.

    Kordless re-resolves your account and workspace context from the new Organization. The URL changes to the new workspace's slug.
  </Step>
</Steps>

## Join by invitation

If someone invites you to their Organization, you receive an email invitation from Clerk. Accept the invitation to join that Organization. After joining, the Organization appears in your OrganizationSwitcher.

## What happens when the URL names another workspace

If you open a URL that names an Organization you do not belong to, Kordless shows a recoverable context state — not guessed content. You see "Choose an organization" with a link to set up or select one.

## Workspace versus connected Account

|                  | Workspace                         | Connected Account                             |
| ---------------- | --------------------------------- | --------------------------------------------- |
| Created through  | Clerk Organization creation       | Accounts capability                           |
| Switched through | OrganizationSwitcher              | Accounts portfolio                            |
| Visible in       | Sidebar + URL slug                | Accounts list with drill-down                 |
| Billing          | One subscription per Organization | Billing responsibility may differ from access |
| Credentials      | Workspace-scoped API keys         | Connection-scoped access                      |

<Warning>
  Never use Accounts to switch among your own Organizations. Accounts is for third-party businesses, not for workspace switching.
</Warning>

## If it does not work

<Accordion>
  <AccordionItem title="No active Organization">
    If you see "Choose an organization," you need to create or select a Clerk Organization. Use the link on the page to go to the welcome screen.
  </AccordionItem>

  <AccordionItem title="Organization not provisioned">
    If the Organization exists in Clerk but Kordless shows a provisioning state, the backend convergence step may not have completed. The welcome screen retries automatically. If it fails, use the "Try again" button.
  </AccordionItem>

  <AccordionItem title="Cannot find a connected Account in the switcher">
    Connected Accounts do not appear in the OrganizationSwitcher. They appear in the Accounts portfolio when the capability is enabled. See [Accounts overview](/accounts/overview).
  </AccordionItem>
</Accordion>

## Next

<Card title="Start your first Book" icon="rocket" href="/product/getting-started/start-your-first-book">
  Choose the correct starting method for your pricing knowledge.
</Card>