---
title: "Create new user"
method: POST
path: "/users"
tags: ["Users"]
---

# Create new user

`POST /users`

## Request

- Base URL: `https://connect.clever.gy`
- URL: `https://connect.clever.gy/users`
- Auth: API key in header `clevergy-api-key`

Creates a new user and returns the id and the status of the created user

## Request body

- UserRegistration
  - `name` string
  - `surname` string
  - `email` string, email
  - `dni` string
  - `phoneNumber` string
  - `language` 'es-ES' | 'en-US' | 'ca-ES' | 'gl-ES' | 'eu-ES': User language in BCP 47 format, one of the languages the app is available in: `es-ES` (Spanish), `en-US` (English), `ca-ES` (Catalan), `gl-ES` (Galician) and `eu-ES` (Basque). If it is not specified, the tenant's default language is used. Any other value is rejected with a 400.

## Response `200`

Record successfully added.

- UserCreated
  - `id` string
  - `status` string

## Other responses

- `400`: Bad request (user already exists, or the language is not one of the accepted codes)
- `401`: Unauthorized
- `409`: User already exists with this email
- `default`: Unexpected error

---

[API](https://skmtc.dev/clevergy/apis/clevergy-connect-api.md) - [All operations](https://skmtc.dev/clevergy/apis/clevergy-connect-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clevergy/apis/clevergy-connect-api/revisions/d333c5eecb5b?raw)