---
title: "Create a user"
method: POST
path: "/api/v1/auth/users"
tags: ["User Authorization"]
---

# Create a user

`POST /api/v1/auth/users`

## Request

- Base URL: `https://www.gooddata.ai`
- URL: `https://www.gooddata.ai/api/v1/auth/users`
- Auth: none declared

Create a user - dedicated endpoint for user management in the internal OIDC provider. GoodData.CN specific

## Request body

- AuthUser: Entity representing user in authentication system.
  - `authenticationId` string: Field which is stored as the authenticationId in metadata. Must be absent on POST. On PUT it must be absent, or equal to the value calculated by the backend (e.g. as returned from a previous GET).
  - `displayName` string, required: User description, which will be visible in application.
  - `email` string, email, required: Email - used as lookup (must be unique). For PUT method, it must be same as in URL
  - `password` string: User password. Write-only - accepted on POST and PUT, never returned in a response.

## Response `201`

Created

- AuthUser: Entity representing user in authentication system.
  - `authenticationId` string: Field which is stored as the authenticationId in metadata. Must be absent on POST. On PUT it must be absent, or equal to the value calculated by the backend (e.g. as returned from a previous GET).
  - `displayName` string, required: User description, which will be visible in application.
  - `email` string, email, required: Email - used as lookup (must be unique). For PUT method, it must be same as in URL
  - `password` string: User password. Write-only - accepted on POST and PUT, never returned in a response.

## Other responses

- `400`: The payload carries no password, or carries an authenticationId.
- `404`: The caller has no FULL_CONTROL permission on the organization.

---

[API](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api.md) - [All operations](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/revisions/c728ef303bfb?raw)