---
title: "Register a new account (username is confirmed later, during onboarding)"
method: POST
path: "/auth/register"
tags: ["Auth"]
---

# Register a new account (username is confirmed later, during onboarding)

`POST /auth/register`

## Request

- Base URL: `https://whatareyoudo.ing/api/v1`
- URL: `https://whatareyoudo.ing/api/v1/auth/register`
- Auth: none declared

## Request body

- RegisterRequest
  - `email` string, email, required
  - `password` string, required
  - `captchaToken` string
  - `displayName` string
  - `locale` string: The language of the confirmation mail (one of the app's fifteen; Accept-Language, then English, when absent).

## Response `201`

Created

- object
  - `data` object, required
    - `user` object, required
      - `id` string, uuid, required
      - `emailVerificationRequired` true, required
  - `meta` object, required
    - `requestId` string, required

## Other responses

- `422`: EMAIL_ALREADY_EXISTS, or another validation failure

---

[API](https://skmtc.dev/whatareyoudo/apis/whatcha-api.md) · [All operations](https://skmtc.dev/whatareyoudo/apis/whatcha-api/llms.txt) · [OpenAPI document](https://skmtc.dev/whatareyoudo/apis/whatcha-api/revisions/48dd8a54abea?raw)