For a list of available CSV fields and its details, see Control Hub user management CSV file reference.

Before you begin

If you have more than one CSV file for your organization, upload and import each file separately. Wait for each task to complete before proceeding to the next CSV file.

For customers in the Asia-Pacific region (including Japan, China, and Hong Kong), the Caller ID automatically populates from the First Name and Last Name fields. The import operation ignores the Caller ID First Name and Caller ID Last Name fields.

Here are some recommendations:

  • Some spreadsheet editors remove the + sign from cells when they open the CSV file. We recommend that you use a text editor to make CSV updates. If you use a spreadsheet editor, ensure that you set the cell format to text and restore removed + signs.
  • Export a new CSV to capture the latest information for the fields and avoid errors during the import of changes.

1

Sign in to Control Hub.

2

Go to Management > Users.

3

Click the drop-down next to Add users, then select Manage users by CSV.

4

Choose how to manage users.

  • Export CSV
  • Download CSV template
You can also choose to include User attributes, User licenses, or both when exporting the CSV file.
5

Enter the new users' information on new lines in the CSV file.

  • The User ID/Email (Required) column is the only mandatory field.

  • If you have a specific directory and external numbers for each new user, then include the leading + for external numbers without other characters.

  • To assign a service, add TRUE in that service's column. To exclude a service, add FALSE.

    If you’re using automatic license assignments, leave the service columns empty when creating users with the CSV import. Webex automatically assigns the licenses for those services to the new users.

    Any suspended services will appear as (Suspended) in the respective column header within the CSV file. Control Hub won't upload a CSV file with a suspended service marked TRUE.

  • To assign a location, enter the its name in the Location column. If you do not specify the location in the CSV, user onboarding fails.

  • If you’re adding users as supervisors for Webex Contact Center, add users manually. You can only assign Standard and Premium roles using a CSV.

While entering a user's name, enter both the first and last name.

The user CSV no longer includes the columns for UC Manager Profile, Calling Behavior, and Calling Behavior UC Manager Profile. Use the calling template to manage the Call Behavior and UCM Profile in bulk. For more information, see Set up calling behavior.

6

Click Choose a file and add the updated CSV file.

7

Choose Add services only.

This is the best option when adding new users, especially if you’re using automatic license assignment.

Use Add and remove services if you’re disabling services for users.

8

Click Upload.

The CSV file uploads and creates your task. You can close the browser or this window. However, your task continues to run. To review the progress of your task, see Manage tasks in Webex Control Hub.