Create Users

Use this endpoint to create new user accounts in Tenovos, whether local (username and password) or a federated (SSO) user account. Depending on the quantity of users being created, and current processing times, we will determine how best to process your request. If run as a batch, the response will be an HTTP Status Code of 202, and the task id will be returned. Use the task endpoint to request the status and other task information.

SecurityOAuth2
Request
header Parameters
content-type
string
Example: application/json
Authorization
string
Example: Bearer <token>
Request Body schema: application/json
Array ([ 1 .. 50 ] items)
firstName
string
lastName
string
friendlyName
string
email
string <email>
username
string or null

Username for the Account

password
string or null

Enter a temporary password for the user if the account is a local account.

accountType
string
Enum: "local" "federated"
country
string or null
company
string or null
phone
string or null
contact
string or null

Provide a name for the Point of Contact associated to this user.

roleId
string

The ID of the Role that will be assigned to this user

proofing
boolean or null

Set to true if you'd like to assign a proofing license to this user and automatically provision their proofing account.

groupIds
Array of strings (user-groups)

List of user group IDs to assign when creating users or that the user belongs to.

Responses
200

Successful Request. User Created Successfully.

202

Successful Request. Batch creation of users has started.

400

One or more required parameters are missing or invalid.

401

Authentication failed (unauthorized).

403

Forbidden. You do not have permissions to perform this action, or your connection information is not correct.

503

The server is too busy to handle the request.

post/users/create
Request samples
application/json
[
  • {
    }
]
Response samples
application/json
{
  • "users": [
    ]
}