> ## 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.

# Connect an existing Account

> Connect a third-party Account that already exists in Kordless.

Connect your workspace to an existing Kordless Account through an explicit connection request. The Account remains independent — your workspace gains access only after the Account's administrator accepts.

## Before you start

* You must be an **organization admin**.
* Accounts must be **enabled** for your workspace. See [Enable Accounts](/accounts/enable-accounts).
* Obtain the **Kordless Account ID** from the third-party business. This is a UUID that identifies their Account in Kordless.
* 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).

<Note>
  Create and connect are separate procedures because one creates a commercial identity and the other creates a relationship to an existing identity. If the business does not yet have a Kordless Account, use [Create an Account](/accounts/create-an-account) instead.
</Note>

## Steps

<Steps>
  <Step title="Open Accounts and click Add Account">
    In the sidebar, open **Accounts**. Click **Add Account** to open the onboarding form.
  </Step>

  <Step title="Choose Connect existing">
    The Add Account page shows two tabs: **Create new** and **Connect existing**. Select **Connect existing** to request access to an Account that already exists in Kordless.
  </Step>

  <Step title="Enter the Kordless Account ID">
    Type or paste the Account ID. The field expects a UUID in the format `00000000-0000-0000-0000-000000000000`.

    The Account remains independent. Its administrator must accept this connection before access begins.
  </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).
  </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 connected 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 Send connection request">
    Click **Send connection request**. Kordless creates a pending connection. The Account appears in your portfolio with an "Awaiting acceptance" status.
  </Step>
</Steps>

## Success

You are redirected to the Accounts portfolio filtered to pending connections. The connected Account appears with an **Awaiting acceptance** chip. Access begins only after an administrator for the connected Account accepts the request.

<Warning>
  A pending connection does not grant access. Until the connected Account's administrator accepts, your workspace cannot view, integrate, or manage the Account.
</Warning>

## 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 send the connection request.
  </AccordionItem>

  <AccordionItem title="Account ID not found">
    The Account ID does not match an existing Kordless Account, or the Account is not accepting connections. Confirm the UUID with the third-party business and try again.
  </AccordionItem>

  <AccordionItem title="Connection already exists">
    If an active or pending connection already exists between your workspace and the target Account, Kordless will not create a duplicate. Check the portfolio for the existing connection.
  </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>