Skip to main content
An Account establishes access to a Neuron. A Legal Identity represents an actor for workflows that require reviewed identity data, signatures, contract participation, or another stronger trust decision. They are related, but they are not interchangeable.

Why the distinction matters

Logging in proves control of account credentials. It does not by itself prove that the account has a current Legal Identity or that a relying application should accept that identity for a particular purpose. An application must state its own requirement explicitly:

Onboarding paths

State applications must retain

Persist identifiers and status needed to resume the workflow. Do not use display names or email addresses as substitutes for returned account, application, key, or Legal Identity identifiers. Identity review is asynchronous. The application must handle at least a pending outcome and a terminal approved or rejected outcome using the delivery or query mechanism supported by its Neuron.

Keep account and identity data separate

Never put an account-creation API secret in browser or distributable mobile code. A browser onboarding flow can differ from normal Agent API JSON requests and may use hosted forms, redirects, and a session-token exchange; follow the dedicated guide instead of adapting backend examples.

Reference