User Upload

User Upload is a simple way to perform bulk uploads or updates of user information in xMatters. The latest edition of this feature requires fewer clicks to send files, and provides you with more robust reporting features when file processing is complete.

Based on our xMatters REST API, the User Upload feature uses the User Upload Template v1.6; accepted file formats are .csv and .txt, and the maximum file size is 10,000 rows. To help avoid any potential issues with special characters in user names, we recommend encoding the file using UTF-8.

The previous version of the file, User Upload Template v1.5 is still valid for uploads, but changes to the Status, External Key, and Externally Owned fields will be ignored on upload. If you only need to add or update a few users, you can do so on the Users page of the web user interface. For more information, see Manage Users.

Upload files

Ensure you are using the User Upload Template v1.6 with the User Upload feature. You can download a copy of the template file, or create your own by exporting a list of existing users from the Users page of the user interface. For more information on modifying the template or downloading the file, see Modify the upload template file.

You can upload files from either the Reports or Users pages.

Once xMatters receives the file, you're taken back to the User Upload report page where you can see the file and review its progress. If you have other things to do while your file processes, go do them; we'll send you an email confirmation when the file has finished processing. For more information, see Subscribe to User Upload alerts.