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

# User onboarding

> Create, verify, and activate a Neuron account

## When to use this flow

Use this flow when you want to create a Neuron account from a trusted back-end
service and guide the user to a verified, active session.

## Flow overview

```mermaid theme={null}
sequenceDiagram
  participant Client
  participant Neuron
  Client->>Neuron: Account/DomainInfo (optional)
  Client->>Neuron: Account/Create (HMAC + API key)
  Neuron-->>Client: JWT + disabled account
  Client->>Neuron: Account/VerifyEMail (code)
  Neuron-->>Client: verified
  Client->>Neuron: Account/Login (HMAC)
  Neuron-->>Client: JWT
```

## Steps

1. Optional: call `Account/DomainInfo` to show a human-friendly domain name.
2. Call `Account/Create` to create the account and receive an initial JWT.
3. Prompt the user to enter the email verification code.
4. Call `Account/VerifyEMail` to enable the account.
5. Call `Account/Login` to obtain a fresh JWT for ongoing use.

## Common pitfalls

* Reusing a nonce will invalidate the request.
* An unverified account cannot use most endpoints.
* If login fails after verification, check the host used for signing.

## Next steps

* Continue to [Messaging flow](/guides/messaging).
* Review [Authentication](/guides/authentication).