Required fields for the User Upload file

Question

What are the required fields in the User Upload CSV file? I want to update or remove specific user information without completing all the fields.

Environment

All versions of xMatters

Answer

For the User Upload file, the required fields depend on the type of operation you are performing:

• Add or update users: The User field (initial user ID / web login ID) is required. Include only the columns you want to add or update, plus any other fields required by your configuration.

• Delete users: The operation field (set to remove) and the User (username) field are required. This will remove the specified users from the system.

When completing the User Upload, you should only include the columns (fields) that you intend to change. However, be aware that for any user row you include:

• If a field has a value in the upload file, it will replace the existing value in xMatters.

• If a field is present in the file but left blank, it will clear (delete) the existing value in xMatters.

Note: The UUID field is specifically not required and incorrect values may lead to issues. For example, the same user will have a different UUID value in Non-Production and Production environments.

To learn more about the User Upload, see our online help.