Skip to main content
POST
Create user
Requires an active session with the admin role. The email with the credentials is sent first and then the user is saved: if the email cannot be sent, it returns 502 and nothing is created, so it can be retried.

Path parameters

string
required
Email address of the new user. If it doesn’t have a valid format, it returns 400.

Request body

It must have exactly these three fields, with non-empty text: if any is missing, extra or empty, it returns 400.
string
required
Name of the institution the user belongs to.
string
required
ROR identifier of the institution. Example: 059yx9a68. Each institution has a single user: if one already exists for that ror_id, it returns 409.
string
required
User’s role on the platform. Example: staff. It cannot be admin: it returns 403.

Response

boolean
true if the user was created successfully.
string
Confirmation or error message.