---
title: "Creates a new user"
method: POST
path: "/api/Users"
tags: ["Users"]
---

# Creates a new user

`POST /api/Users`

## Request

- Base URL: `https://api2.globalfinreg.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api2.globalfinreg.com/api/Users`
- Auth: HTTP bearer

## Request body

- CreateUserReq
  - `firstName` string, nullable
  - `lastName` string, required
  - `languageCode` string, required
  - `currencyCode` string, required
  - `email` string, required
  - `priceTokenCode` string, nullable
  - `identityScheme` string, nullable
  - `identitySchemeUuid` string, nullable
  - `allowContact` boolean, nullable

## Response `200`

The new user was created. User details included in the response body

## Other responses

- `400`: Problems with the request. Check the the returned body for details.
- `401`: A user with this email exists in our database but authentication against auth0 with the passed credentials was not successful.
- `422`: A user already exists for this firebase user. No changes made.

---

[API](https://skmtc.dev/globalfinreg/apis/gfr-ai-agents-api.md) · [All operations](https://skmtc.dev/globalfinreg/apis/gfr-ai-agents-api/llms.txt) · [OpenAPI document](https://skmtc.dev/globalfinreg/apis/gfr-ai-agents-api/revisions/f8afe0178e1b?raw)