> ## 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 an Account

> Create a new third-party Account identity in Kordless.

Create a new independent business identity with its own Book, Test and Live environments, and history — then connect your workspace to it with explicit access and billing responsibility.

## Before you start

* You must be an **organization admin**.
* Accounts must be **enabled** for your workspace. See [Enable Accounts](/accounts/enable-accounts).
* Know the **name** of the business you are creating.
* Decide the **access level** your workspace should have. See [Access levels](/accounts/access-levels).
* Decide **who pays** for this Account's active Book use. See [Billing responsibility](/accounts/billing-responsibility).

## Steps

<Steps>
  <Step title="Open Accounts and click Add Account">
    In the sidebar, open **Accounts**. If the portfolio is empty, click **Add Account**. If you have existing connected Accounts, the **Add Account** button is in the page header.
  </Step>

  <Step title="Choose Create new">
    The Add Account page shows two tabs: **Create new** and **Connect existing**. Select **Create new** to create an independent Account identity rather than connecting to one that already exists.
  </Step>

  <Step title="Enter the Account name">
    Type the business name (up to 160 characters). This creates an independent business identity with isolated Test and Live environments.
  </Step>

  <Step title="Choose the access level">
    Select the access your workspace should have for this Account:

    * **View only** — Inspect readiness, Book state, Quotes, and Settings.
    * **Integration access** — Use the Account through approved API and component surfaces.
    * **Full access** — Operate the Book and approved commercial workflows.

    Access can be reduced or revoked later. See [Access levels](/accounts/access-levels) for details.
  </Step>

  <Step title="Choose billing responsibility">
    Select who pays for this Account's active Book use:

    * **This workspace pays** — Your workspace is billed for the connected Account's active Books.
    * **The connected Account pays** — The new Account is billed for its own use.

    Billing responsibility is explicit and separate from access. See [Billing responsibility](/accounts/billing-responsibility).
  </Step>

  <Step title="Click Create Account">
    Click **Create Account**. Kordless creates the Account identity, provisions Test and Live environments, and establishes the controller connection. You are redirected to the connected Account's drill-down page.
  </Step>
</Steps>

## Success

You land on the connected Account's detail page. It shows the Account name, the acting workspace, the access level, Book readiness (Not started), billing responsibility, and the Account ID. The connection is active immediately because your workspace created the identity.

## If it does not work

<Accordion>
  <AccordionItem title="Accounts is not ready">
    If the page shows "Accounts is not ready," enable Accounts for your workspace first. See [Enable Accounts](/accounts/enable-accounts).
  </AccordionItem>

  <AccordionItem title="Only an organization admin can create or connect an Account">
    You are signed in as a member. Ask a workspace admin to create the Account, or ask for the admin role in your Clerk Organization.
  </AccordionItem>

  <AccordionItem title="Name is too long">
    The Account name must be 160 characters or fewer. Shorten the name and try again.
  </AccordionItem>

  <AccordionItem title="Request failed">
    If Kordless could not complete the request, check your network connection and try again. Creation is idempotent — retrying with the same details does not create a duplicate Account.
  </AccordionItem>
</Accordion>

## Next

<CardGroup cols={2}>
  <Card title="Access levels" icon="shield" href="/accounts/access-levels">
    What view, integration, and full access mean for a connected Account.
  </Card>

  <Card title="Monitor connected Accounts" icon="layout-grid" href="/accounts/monitor-connected-accounts">
    Inspect readiness and status across connected Accounts.
  </Card>
</CardGroup>