---
title: "Create a new user"
method: POST
path: "/v1/users"
tags: ["authentication"]
---

# Create a new user

`POST /v1/users`

## Headers

- `X-Fields` string, mask

## Request body

- UserInput
  - `email` string
  - `metadata` object
  - `active` boolean

## Response `201`

Success

- User
  - `email` string
  - `metadata` object
  - `active` boolean
  - `id` string — The user instance unique identifier
  - `created` string — time the user was created
  - `apiKey` string
  - `company` string
  - `sysAdmin` boolean
  - `groups` string[]
  - `plan` 'FREEMIUM' | 'FULL'
  - `username` string
  - `backofficeAdmin` boolean
  - `trialDays` integer
  - `organizationMemberships` OrganizationMember[]
    - `id` integer
    - `status` 'INVITED' | 'ACTIVE' | 'INACTIVE'
    - `role` 'MEMBER' | 'OWNER'
    - `invited` string, date-time
    - `accepted` string, date-time
    - `created` string, date-time
    - `orgId` integer
    - `orgUsername` string
    - `userId` integer
    - `userEmail` string

## Other responses

- `400` — Invalid Parameters

---

[API](https://skmtc.net/super/apis/super-ai-api.md) · [All operations](https://skmtc.net/super/apis/super-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/super/super-ai-api/revisions/0d125680e232/schema)