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

# Create User

`POST /api/v3/users`

Create a new user with the provided ID, nickname, and global name. If the user already exists, this is a no-op. Duplicate primary keys are reported with a 400.

## Request body

- UserCreateRequest
  - `id` integer, required
  - `global_name` string, required
  - `nickname` string, required

## Response `201`

Document created, URL follows

- UserResponse
  - `id` integer, required
  - `global_name` string, nullable
  - `nickname` string, nullable
  - `overwatch_usernames` string[], nullable
  - `coalesced_name` string, nullable
  - `coins` integer

## Other responses

- `400` — Bad request syntax or unsupported method

---

[API](https://skmtc.net/genji/apis/genji-shimada-api.md) · [All operations](https://skmtc.net/genji/apis/genji-shimada-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/genji/genji-shimada-api/versions/6db12055b305/schema)