Skip to developer documentation
Attriboo
Start free
Browse developer documentation
OpenAPI JSONFull Markdown referenceMCP tool referenceCLI command referenceHelp center
CLI documentation / Installation and session

Sign in

attriboo login

Open browser sign-in and save the approved workspace's rotating OAuth credentials.

Access: Account-holder sign-in and approval

Options

attriboo login options
FieldTypeDescription
--setupbooleanRequest analytics:read sites:write for owner/admin website setup.
--no-browserbooleanPrint the sign-in link instead of opening it automatically. Open it on the same computer.
--jsonbooleanCompact JSON instead of formatted JSON.
--csvbooleanCSV for the main row collection; nested values remain JSON cells. Cannot be combined with --json.

Sign in for reports

Replace example websites, dates and cursor values with your own. Running these commands makes real requests or changes the local session.

Terminal command
attriboo login

Example output

Illustrative stdout
{
  "signed_in": true,
  "scope": "analytics:read"
}

Approve website setup

Replace example websites, dates and cursor values with your own. Running these commands makes real requests or changes the local session.

Terminal command
attriboo login --setup

Example output

Illustrative stdout
{
  "signed_in": true,
  "scope": "analytics:read sites:write"
}

Open the link yourself

Replace example websites, dates and cursor values with your own. Running these commands makes real requests or changes the local session.

Terminal command
attriboo login --no-browser

The sign-in URL is printed on stderr. This result is printed only after approval finishes.

Example output

Illustrative stdout
{
  "signed_in": true,
  "scope": "analytics:read"
}

Behavior and limits

Requires the Node.js version shown on the CLI overview. Login uses PKCE and a temporary loopback callback. The browser must run on the same computer as the CLI; this is not device-code login.

Default sign-in reads reports. Setup requires a fresh owner/admin approval. A previous report-only grant is not silently upgraded.

The local sign-in attempt times out after three minutes. If it expires, run login again. Never share the authorization URL or the saved credentials.

A privately configured ATTRIBOO_API_KEY takes precedence over saved OAuth credentials. Remove that environment override when you intend to use setup OAuth.

Exit codes and troubleshootingEnvironment and credentials