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

# Register a new user account

`POST /auth/register`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/auth/register`
- Auth: none required

## Request body

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

## Response `201`

User registered and tokens issued

- AuthResponse
  - `success` boolean
  - `data` object
    - `user` User
      - `id` string, uuid
      - `email` string, email
      - `name` string
      - `phone` string, nullable
      - `jobTitle` string, nullable
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
    - `accessToken` string
    - `refreshToken` string
    - `expiresIn` integer: Access token TTL in seconds
    - `companyId` string, nullable: Primary company for customer-app session routing
    - `canSeeInternalUi` boolean: True when the primary company is allowlisted for customer-app preview UI
    - `memberships` UserContextMembership[]
      - `companyId` string, uuid
      - `companyName` string, nullable
      - `role` 'owner' | 'admin' | 'cfo' | 'member' | 'viewer'

## Other responses

- `409`: Email already registered
- `422`: Validation error

---

[API](https://skmtc.dev/medianfi/apis/median-api.md) · [All operations](https://skmtc.dev/medianfi/apis/median-api/llms.txt) · [OpenAPI document](https://skmtc.dev/medianfi/apis/median-api/revisions/20090ea32b0d?raw)