---
title: "Register a user"
method: POST
path: "/api/v1/users/register"
tags: ["Register"]
---

# Register a user

`POST /api/v1/users/register`

Signup has to be enabled and signup approval is not required

## Request body

- RegisterUser
  - `channel` object — channel base information used to create the first channel of the user
    - `displayName` string
    - `name` string — immutable name of the channel, used to interact with its actor
  - `displayName` string — editable name of the user, displayed in its representations
  - `email` string, email, required — email of the user, used for login or service communications
  - `password` string, password, required
  - `username` string, required — immutable name of the user, used to find or mention its actor

## Response `204`

successful operation

## Other responses

- `400` — request error
- `403` — user registration is not enabled, user limit is reached, registration is not allowed for the ip, requires approval or blocked by a plugin
- `409` — a user with this username, channel name or email already exists

---

[API](https://skmtc.net/cpy/apis/peertube.md) · [All operations](https://skmtc.net/cpy/apis/peertube/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cpy/peertube/versions/efe11b159e43/schema)