> ## 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.

# Overview

The Accounts & onboarding endpoints cover the full lifecycle of a Neuron account — from initial creation through contact verification, account recovery, and transferring an account to another application.

These endpoints are typically the starting point for any integration. Most other API groups require an active, verified account with a valid JWT before they can be used.

## Endpoints

| Endpoint                                                                                                 | Description                                                                                                          |
| -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| [Domain info](/neuron-api/api-reference/accounts-and-onboarding/domain-info)                             | Retrieve human-readable information about the server domain. Call this first to let users choose a service provider. |
| [Create account](/neuron-api/api-reference/accounts-and-onboarding/create-account)                       | Create a new Neuron account and receive an initial JWT. Requires an API key and HMAC signature.                      |
| [Create web form](/neuron-api/api-reference/accounts-and-onboarding/create-web-form)                     | Create an agent account via a browser-based web form — suitable when you cannot protect API secrets client-side.     |
| [Verify email](/neuron-api/api-reference/accounts-and-onboarding/verify-email)                           | Submit the email verification code to enable the account.                                                            |
| [Verify phone number](/neuron-api/api-reference/accounts-and-onboarding/verify-phone-number)             | Submit the phone verification code if a phone number was provided during account creation.                           |
| [Resend verification codes](/neuron-api/api-reference/accounts-and-onboarding/resend-verification-codes) | Resend email or phone verification codes if the originals were not received.                                         |
| [Recover](/neuron-api/api-reference/accounts-and-onboarding/recover)                                     | Recover access to an account using a recovery code or alternative credential.                                        |
| [Info](/neuron-api/api-reference/accounts-and-onboarding/info)                                           | Retrieve basic information about the current account.                                                                |
| [Transfer](/neuron-api/api-reference/accounts-and-onboarding/transfer)                                   | Transfer the account to another application, such as a mobile wallet, using a QR-code-based onboarding URI.          |

## Typical onboarding flow

```mermaid theme={null}
sequenceDiagram
  participant Client
  participant Neuron
  Client->>Neuron: GET Account/DomainInfo
  Client->>Neuron: POST Account/Create (HMAC + API key)
  Neuron-->>Client: JWT + disabled account
  Client->>Neuron: POST Account/VerifyEMail (verification code)
  Neuron-->>Client: Account enabled
  Client->>Neuron: POST Account/Login
  Neuron-->>Client: JWT (active session)
```

1. Call `DomainInfo` to display the domain name and description to the user (optional).
2. Call `Create` with HMAC-signed credentials to create the account and receive an initial JWT.
3. Prompt the user to enter the verification code sent to their email address.
4. Call `VerifyEMail` to activate the account.
5. Call `Login` to get a fresh JWT for ongoing API use.

## Authentication notes

* `DomainInfo` requires no authentication.
* `Create` and `CreateWebForm` require an HMAC-signed API key — see the [Authentication guide](/neuron-api/authentication).
* All other endpoints in this group require a JWT bearer token obtained from `Create` or `Login`.
* New accounts are **disabled** until email verification is complete. Disabled accounts cannot use most other endpoints.

## Related

* [Authentication & sessions](/neuron-api/api-reference/authentication-and-sessions/overview) — log in, refresh, and manage tokens after account creation.
* [User onboarding guide](/neuron-api/guides/user-onboarding) — step-by-step walkthrough of the full onboarding flow.
* [Authentication guide](/neuron-api/authentication) — how HMAC signing and JWT tokens work.