---
title: "Register"
method: POST
path: "/api/v1/auth/register"
tags: ["authentication"]
---

# Register

`POST /api/v1/auth/register`

## Request

- Base URL: `https://mcp.fless.io` (the document declares no server; this is the origin it was published from)
- URL: `https://mcp.fless.io/api/v1/auth/register`
- Auth: none declared

Register a new user.

If `become_ambassador=True`, also creates an ACTIVE ambassador record so the
user can start referring immediately (auto-approve flow used by the
ambassador Join CTA).

## Request body

- UserCreate
  - `email` string, email, required
  - `first_name` string, required
  - `last_name` string, required
  - `phone` string, nullable
  - `address_street` string, nullable
  - `address_city` string, nullable
  - `address_state` string, nullable
  - `address_zip` string, nullable
  - `password` string, required
  - `referral_code` string, nullable
  - `become_ambassador` boolean
  - `account_type` 'individual' | 'realtor'
  - `brokerage_name` string, nullable
  - `website` string, nullable

## Response `201`

Successful Response

- UserResponse
  - `email` string, email, required
  - `first_name` string, required
  - `last_name` string, required
  - `phone` string, nullable
  - `address_street` string, nullable
  - `address_city` string, nullable
  - `address_state` string, nullable
  - `address_zip` string, nullable
  - `id` integer, required
  - `role` string, required
  - `is_active` boolean, required
  - `email_verified` boolean, required
  - `account_type` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `last_login` string, date-time, nullable
  - `calendar_configured` boolean
  - `default_availability_start` string
  - `default_availability_end` string
  - `default_availability_days` string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/fless/apis/apartment-hunting-platform.md) · [All operations](https://skmtc.dev/fless/apis/apartment-hunting-platform/llms.txt) · [OpenAPI document](https://skmtc.dev/fless/apis/apartment-hunting-platform/revisions/f542b37a2fcf?raw)