Skip to main content

​
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

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.

​
2. Pick the account to operate on

List the accounts you can access: 
landbase-cli account list

{
  "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: 
landbase-cli account set

Multiple accounts available — pick one:
  [1] Acme Corp (39)
  [2] Beta LLC (449)
  [3] Globex Inc (722)
  [4] Initech (962)
Enter 1-4:
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>.

​
3. Fill the onboarding profile

See which fields still need answers: 
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: 
echo '{"aboutCompany":{"description":"We sell AI-powered prospecting tools."}}' \
  | landbase-cli onboarding update --json -
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.
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. Make sure you’re viewing the same account you selected in step 2.