POST /api-tm/system/tenants/{tenant}/users

Create a new user with the given properties for the specified tenant.

Required user role: YUUVIS_TENANT_ADMIN

The properties for the new user are passed in JSON format. In the response, the user ID is returned again in JSON format.

The only required parameter is username, but the parameter email is recommended. The specified email address is used for invitation after creation and in the scenario of a forgotten password.

The option to disable a user is the recommended alternative instead of a deletion. The username might be required for compliance issues.

The user is created with the Keycloak settings shown in the screenshot below (click to enlarge). The first steps the created user has to do are under Required User Actions the entries Update Password and Update Profile. Hence, the new user has to register by setting a password and other user data. An  invitation via email guides the new user to the registration portal.

yuuvis® Momentum client as reference implementation displays the user's name in the following format: lastName, firstName (username).

Will come with Release Candidate with tag 1.1.0-rc2: If the password is not set but email and the call parameter withInvitation is given with true an invitation email is sent by Keycloak to the given address.