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

# POST /api/auth/register/email — create account with email

> Create an Aria Compute account with an email address and password. Returns a session token and sends the welcome email when SMTP is configured.

Create a new Aria Compute account with an email address and password. Returns a session JWT and the new user profile. When SMTP is configured, the backend also sends the `user_registered` welcome email.

**Method:** `POST` **Path:** `/api/auth/register/email` **Auth:** None

## Request

<ParamField body="email" type="string" required>
  Email address. Must be unique.
</ParamField>

<ParamField body="password" type="string" required>
  Account password.
</ParamField>

<ParamField body="name" type="string">
  Optional display name.
</ParamField>

## Response

<ResponseField name="token" type="string">
  Session JWT.
</ResponseField>

<ResponseField name="user" type="object">
  New user profile.
</ResponseField>

## Example

```bash theme={null}
curl -X POST https://ariacompute.com/api/auth/register/email \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "password": "...", "name": "Jane"}'
```

```json theme={null}
{
  "token": "eyJhbGciOi...",
  "user": {
    "id": "usr_01H...",
    "email": "you@example.com",
    "name": "Jane",
    "created_at": "2026-09-23T10:00:00Z"
  }
}
```

## Errors

| Status | Meaning                            |
| ------ | ---------------------------------- |
| `400`  | Invalid email or missing password. |
| `409`  | Email already registered.          |


## Related topics

- [POST /api/auth/login — sign in with email or phone](/api-reference/auth/login.md)
- [POST /api/auth/register/phone — create account with phone](/api-reference/auth/register-phone.md)
- [POST /api/auth/phone/send-otp — send SMS verification code](/api-reference/auth/send-otp.md)
- [Authenticate requests to the Aria Compute API](/authentication.md)
- [Get started with Aria Compute in minutes](/quickstart.md)