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

# Create User

`POST /api/admin/users`

## Request

- Base URL: `https://grandline.luzomi.com`
- URL: `https://grandline.luzomi.com/api/admin/users`
- Auth: none declared

Register a user on their behalf: create the account, mint a key, and
(optionally) email it. The cleartext key is returned once.

## Request body

- AdminCreateUserRequest
  - `full_name` string, required
  - `email` string, required
  - `company_name` string, nullable
  - `designation` string, nullable
  - `unlimited` boolean
  - `mark_verified` boolean
  - `send_email` boolean

## Response `201`

Successful Response

- AdminKeyIssued: Cleartext key shown to the operator once (also emailed when requested).
  - `user_id` integer, required
  - `key_id` integer, required
  - `name` string, required
  - `prefix` string, required
  - `key` string, required
  - `created_at` string, date-time, required
  - `expires_at` string, date-time, nullable, required
  - `emailed` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/luzomi/apis/grandline-api.md) · [All operations](https://skmtc.dev/luzomi/apis/grandline-api/llms.txt) · [OpenAPI document](https://skmtc.dev/luzomi/apis/grandline-api/revisions/4ce06aea012b?raw)