Authentication

Human login and agent-native login

Humans use the normal Privy sign-in flow. Agents can provision and authenticate fully through API without getting stuck in browser-only connect loops.

Human

Use this for team members approving proposals and reviewing activity in the dashboard.

Agent

Agent Login

Provision a Privy user, create workspace API keys, and return KYB status in one API call. By default it also provisions an Ethereum wallet for the agent.

CLI reference

API-first agent provisioning

curl -X POST https://www.0.finance/api/cli/agent-login \
  -H "Content-Type: application/json" \
  -H "x-admin-token: $ZERO_FINANCE_ADMIN_TOKEN" \
  -d '{
    "email": "finance-agent@acme.com",
    "workspace_name": "Acme Finance Agent",
    "company_name": "Acme Inc",
    "beneficiary_type": "business"
  }'

CLI shortcut

zero auth agentlogin \
  --email finance-agent@acme.com \
  --workspace-name "Acme Finance Agent" \
  --company-name "Acme Inc" \
  --beneficiary-type business \
  --admin-token $ZERO_FINANCE_ADMIN_TOKEN

KYB-aware response

The response includes `kyb.status`, `kyb.flow_link`, and starter account provisioning details so agents can decide whether to run KYB steps or proceed in starter mode.

Back to landing