---
title: "Create User"
method: POST
path: "/users"
tags: ["User"]
---

# Create User

`POST /users`

Create a new user

## Request body

- HandlerParamsUserCreate
  - `badge_color` string — The user badge color (hex format)
  - `badge_name` string — The user badge name
  - `email` string, required — The user email
  - `is_admin` boolean, required — The user is an admin
  - `link` string — The user link
  - `name` string, required — The user name
  - `password` string — The user password
  - `receive_email` boolean, required — The user receive email

## Response `200`

OK

- HandlerResponseUserCreate
  - `badge_color` string, required
  - `badge_name` string, required
  - `comment_count` integer, required
  - `email` string, required
  - `id` integer, required
  - `is_admin` boolean, required
  - `is_in_conf` boolean, required
  - `last_ip` string, required
  - `last_ua` string, required
  - `link` string, required
  - `name` string, required
  - `receive_email` boolean, required

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `500` — Internal Server Error

## Changes

- **2024-01-24** `83bbd341664a` — 1 info
  - endpoint added
- **2023-01-28** `6a7a8a92e7c3` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/artalkjs/apis/artalk-api/changes/users/post.md)

---

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