---
title: "Create User"
method: POST
path: "/api/v1/auth"
tags: ["Authentication"]
---

# Create User

`POST /api/v1/auth`

## Request

- Base URL: `https://mockupper.damdafa.com/mockupper`
- URL: `https://mockupper.damdafa.com/mockupper/api/v1/auth`
- Auth: HTTP bearer

Create a new user with username.

This is an authentication endpoint - it handles the initial sign-up.
The token is verified as part of the authentication process, not via dependency.
Provider is determined from X-Provider-Id header (firebase, google, apple).
Automatically determines the Firebase service (yzfoto/avukatim) from the token.

## Headers

- `X-Provider-Id` 'firebase' | 'google' | 'apple'

## Request body

- AuthCreateRequest: Request schema for creating user with Firebase/Apple auth.
  - `name` string, required: User's first name
  - `familyName` string, required: User's last name
  - `gender` string, nullable: User's gender

## Response `201`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/damdafa/apis/mockupper-api.md) · [All operations](https://skmtc.dev/damdafa/apis/mockupper-api/llms.txt) · [OpenAPI document](https://skmtc.dev/damdafa/apis/mockupper-api/revisions/5713d43bfed1?raw)