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

# Register a new user

`POST /v1/auth/signup`

## Request body

- SignupRequest
  - `user` SignupUser, required
    - `email` string, email, required
    - `username` string, required
    - `name` string, required
    - `password` string, required
    - `gender` string
    - `level` string
    - `height` number
    - `height_unit` string
    - `weight` number
    - `goal_weight` number
    - `weight_unit` string
    - `goal_weight_unit` string
    - `max_pushups` integer
    - `max_pullups` integer
    - `max_dips` integer
    - `max_squats` integer
    - `device_id` string
    - `main_goals` string[]
    - `goal` SignupGoal — Optional nested goal. Creates a started goal; status and plannedEndDate are not accepted.
      - `kind` 'improve_skill' | 'lose_weight' | 'increase_strength' | 'build_muscles'
      - `start_date` string, date
      - `end_date` string, date, nullable
      - `technique_guide_id` integer, nullable
      - `current_weight` integer, nullable
      - `planned_weight` integer, nullable
      - `end_weight` integer, nullable
      - `exercise_id` integer, nullable
      - `muscle` string, nullable

## Response `200`

Success

- object
  - `data` object
  - `meta` object
    - `token` string

## Other responses

- `422` — Validation error

---

[API](https://skmtc.dev/thenx/apis/thenx-api-v1.md) · [All operations](https://skmtc.dev/thenx/apis/thenx-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thenx/thenx-api-v1/revisions/22181b7aed6a/schema)