Create a new user

post

https://api.remberg.de/v1/users

Creates a new internal user. Returns 409 if the email already belongs to an internal user, or 209 if the user was created but sending the activation invite mail failed.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

string

required

The login email of the user. Must be unique per tenant.

role

string

required

The role to assign: an internal default-role shorthand (adminUser, managerUser, fullUser, viewerUser) or a role id from GET /v1/users/roles.

firstName

string

required

The first name of the user.

lastName

string

required

The last name of the user.

position

string

The job position of the user.

externalReference

string

A workspace-unique reference to this user in an external system. Must be unique per tenant.

lang

string

enum

The selected system language.

sendInvitationEmail

boolean

Send the activation invite email. Defaults to false (no email is sent).

groupIds

array of strings

User group ids from GET /v1/users/groups.

groupIds

Responses

400

Bad Request

403

Forbidden

409

A user with this email already exists

201Resource created

209User created but sending the activation invite mail was not successful