Skip to main content
Version: 8.1


This function is used in Python Scripting.


Adds a new user to a user source. Used in combination with getNewUser to create new user.

Client Permission Restrictions

Permission Type: User Management

Client access to this scripting function is blocked to users that do not meet the role/zone requirements for the above permission type. This function is unaffected when run in the Gateway scope.


system.user.addUser(userSource, user)


StringuserSourceThe user source to add a user to. If set to an empty string, the function will attempt to use the project's default user source (if called from a project).
UseruserThe user to add, as a User object. Refer also to the PyUser class.


UIResponse - A UIResponse object which contains lists of the errors, warnings, and information returned after the add attempt.


Gateway, Vision Client, Perspective Session

Code Examples

Example #1
# Get new user.
userToGet = system.user.getNewUser("AcmeWest", "mTrejo")

# Add some contact info.
contactInfo = {"email":"","sms": "5551234"}
userToGet.set("password", "thisIsMyPassword")

# Adds a user to the the AcmeWest usersource.
system.user.addUser("AcmeWest", userToGet)