---
title: "Register a new user"
method: POST
path: "/auth/register"
tags: ["Auth"]
---

# Register a new user

`POST /auth/register`

## Request

- Base URL: `https://hoghogh.ai/api/v1`
- URL: `https://hoghogh.ai/api/v1/auth/register`
- Auth: none required

## Request body

- object
  - `email` string, email, required
  - `password` string, required
  - `name` string, required

## Response `201`

User registered

- object
  - `user` User
    - `id` string, uuid
    - `email` string, email
    - `name` string
    - `role` 'lawyer' | 'paralegal' | 'admin'
    - `subscription` 'free' | 'starter' | 'pro' | 'enterprise'
    - `avatar_url` string, nullable
    - `tokens_remaining` integer
    - `trial_active` boolean
    - `trial_ends_at` string, date-time, nullable
  - `accessToken` string
  - `refreshToken` string

## Other responses

- `400`: Validation error
- `409`: Email already in use

---

[API](https://skmtc.dev/hoghogh/apis/chistara-api.md) · [All operations](https://skmtc.dev/hoghogh/apis/chistara-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hoghogh/apis/chistara-api/revisions/457df37a06f7?raw)
