This option allows you to add multiple users to the system in one go. To access this feature, you need to head to the CTU page.

Fig.1 Accessing the CTU via Management menu.


Important note

It is crucial that you ensure all the information is correct before proceeding with the upload of bulk users. Once an import is successful, there is no way to roll it back. If you have a large number of users you will have to manually deactivate them one by one. This will also mean those usernames etc. cannot be used again as they will already exist, albeit inactive.


Also note that your user must be in the team you are trying to upload users to for it to work, and the password field is the only field that's case sensitive.



The CTU

On the CTU page you will notice a button between the Clone button and Filter options. Clicking this will take you to the Bulk user import page.

Fig.2 The CTU page with the page options highlighted.


Fig.3 The Bulk user import page.


Bulk user import table

The page view will show a table of imports that have taken place previously. This will be blank the first time you use the page.

Fig.4 Table headers visible.


Upload statusDisplays the current status of the upload. A 'tick' icon indicates the users have been created successfully. A 'cross' icon indicates there are errors with the upload, check the content of the file to ensure all mandatory fields are entered correctly. A "spinner" icon indicates that the upload is still in progress, please refresh your page or come back later to confirm the status.
UsersThe number of entries within the spreadsheet that were uploaded for creation.
CreatedThe number of users that have been created from the uploaded spreadsheet.
Rows with errors

The number of rows within the spreadsheet that have errors, click on the download button below to download these. Once resolved. re-upload the file to attempt the creation again. 

Uploaded byThis is the name of the user who initiated the bulk user creation.
Upload startThe date and time the bulk user upload process was started.
Upload endThe date and time the bulk user upload process was finished.
DetailsAllows you to see more detail on the import by clicking the 'i' icon.

Successful upload.

Failed upload. Note the download icon on the right to allow you to download, fix and re-upload the users. See table on reasons for failed uploads.

Bulk user import options

Across the top right are the options for this page.

Fig.5 Page options.


Refresh data - Allows the page to be refreshed to display any other uploads that may have occurred whilst viewing the page.
Download import template - Allows you to download the import spreadsheet template to add your user to. The template has columns for
  • First name
  • Last name
  • Login - 40 characters max
  • Password - Case sensitive
  • Permission group (role)
  • Web RTC (TRUE/FALSE)
  • Extension
  • Primary team - you must be in the same team for it to upload correctly
  • Capacity plan
  • Active (TRUE/FALSE)
Allows you to filter the table by the first 5 columns.
Starts the upload process. To do this you will simply need to add the template you have completed and select 'upload' from the dialogue box. Please note the file format must be .csv or .txt only and the file size limit is 100kb.
Add the file and it will inform you if its valid or not.

Once you press upload, you will see pending in the table while the system uploads the user(s).

You should then refresh the table to see the result of the upload as the page doesn't automatically refresh.

Possible reasons for failed upload

File Type: Invalid type. Supported formats: .csv or .txt.
File Size: File cannot be uploaded as it exceeds the 100 KB size limit.
No Entries: File cannot be uploaded as at least 1 row entry is required.
Data Type: The data entered in line no. {0} for the column {Column / Field Name} does not match the expected type.
{Field Name}: Cannot be empty.
{Field Name}: Is too short/long. Ensure this meets the set restrictions.
First Name: Contains invalid characters: Letters, numbers or + - % _ , / ().£$!?@\' characters only.
Last Name: Contains invalid characters: Letters, numbers or + - % _ , / ().£$!?@\' characters only.
Login: File contains multiple users with the same login.
Login: The file uploaded contains logins for users that already exist.
Permission Group: The specified Permission Group does not exist or is a Permission Group higher than yours.
Permission Group: The specified Permission Group does not exist.
Password Policy: The specified password does not meet the complexity requirements for the associated Password Policy.
Primary Team: The specified Primary Team does not exist.
Primary Team: File cannot be uploaded as you are not a member of team name.
Capacity Plan: The specified Capacity Plan does not exist.