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

# Register a new user

`POST /v1/auth/register`

Registers a new user with an email and password. This endpoint can be called unauthenticated to register a new admin, or authenticated (as an admin) to register a standard user into a specific team.

## Request body

- RegisterRequest
  - `email` string, email, required
  - `password` string, required
  - `team_id` string, uuid

## Response `201`

User registered successfully

- object
  - `user` User, required
    - `id` string, uuid, required — Unique user identifier.
    - `email` string, email, required — Email address of the user.
    - `is_verified` boolean, required — Whether the user's email has been verified.
    - `is_admin` boolean, required — Whether the user is an admin.
    - `created_at` string, date-time, required — Timestamp when the user was created.

## Other responses

- `400` — Invalid inputs
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Team Not Found
- `409` — Conflict (Email registered)
- `500` — Internal Server Error

---

[API](https://skmtc.net/px0-ai/apis/px0-api.md) · [All operations](https://skmtc.net/px0-ai/apis/px0-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/px0-ai/px0-api/versions/3ed72443989d/schema)