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

# How to select and onboard an account

> Sign in, pick which account the CLI operates on, and fill in the account's onboarding profile.

# How to select and onboard an account

Before you can run account-level commands you need to be signed in and have an
active account selected. This guide covers signing in, choosing the account, and
filling in its onboarding profile.

***

## 1. Sign in

```bash theme={null}
landbase-cli auth login
```

This opens a browser to complete authentication. Platform sessions last 7 days.

If a command keeps returning `AUTH_FAILED` or a previous session looks stale,
see [troubleshoot authentication](/docs/how-to/troubleshoot-auth).

***

## 2. Pick the account to operate on

List the accounts you can access:

```bash theme={null}
landbase-cli account list
```

```json theme={null}
{
  "accounts": [
    { "id": "39", "name": "Acme Corp", "role": "owner", "current": false },
    { "id": "449", "name": "Beta LLC", "role": "member", "current": false }
  ]
}
```

Then set the active account. Run `account set` with **no arguments** — the CLI
shows a picker and saves your choice to `~/.landbase/platform.json`, so this is a
one-time step per machine:

```bash theme={null}
landbase-cli account set
```

```text theme={null}
Multiple accounts available — pick one:
  [1] Acme Corp (39)
  [2] Beta LLC (449)
  [3] Globex Inc (722)
  [4] Initech (962)
Enter 1-4:
```

<Tip>
  Skipping this step leaves the CLI without an account id, and account-level
  commands exit with `No account id...`. To target a different account for a
  single command without changing the saved one, pass `--account=<id>`.
</Tip>

***

## 3. Fill the onboarding profile

See which fields still need answers:

```bash theme={null}
landbase-cli onboarding get
```

The response includes a `schema` array — one entry per field with its `question`,
`type`, and whether it's `required` and `filled`. Submit answers as a partial
payload:

```bash theme={null}
echo '{"aboutCompany":{"description":"We sell AI-powered prospecting tools."}}' \
  | landbase-cli onboarding update --json -
```

<Warning>
  `aboutCompany` and `aboutCompetition` merge field-by-field, so you can send
  just the field you're changing. `aboutAudience` must be a **complete** segment
  in one payload. Full field-type and clear-a-field rules:
  [onboarding output schemas](/docs/reference/output-schemas#onboarding-update).
</Warning>

Once you've submitted your answers, you can verify the saved details in the web
app under your account's business profile at
[app.landbase.com/setting?category=profile\&tab=business-profile](https://app.landbase.com/setting?category=profile\&tab=business-profile).
Make sure you're viewing the same account you selected in step 2.

***

## Related

* [account command reference](/docs/reference/account)
* [onboarding command reference](/docs/reference/onboarding)
* [How to import contacts](/docs/how-to/import-contacts)
* [Platform mode vs. legacy mode](/docs/explanation/platform-vs-legacy)