Skip to main content

Properties

NameTypeFormatDescription
idstringGUIDThe user identifier as a 128 bit GUID
usernamestring-The user's username
emailstring-The user's email
firstNamestring-The user's first name
lastNamestring-The user's last name
timezonestringtimezone offset nameThe user's timezone preference
languagestringlanguage code The user's language preference
custom.*object-Additional custom data stored against the user
credentialsobject-Container for authentication details
credentials.passwordstring-The password value when creating a user. The value is never returned in a response
credentials.passwordChangeFrequencyinteger-Sets the number of days before a password expires and has to be changed, unless set to 0, in which case the password never expires. This property can only be set by System Administrators. For Active Directory integrated users, the value is always null and cannot be changed.
statusobject-Container for status information
status.activeboolean-A flag to indicate whether the user is active
status.lockedboolean-A flag to indicate whether the user's access has been locked
status.passwordResetRequiredboolean-A flag to indicate whether the user's password requires resetting
createddatetime-The date and time the user was first created
modifieddatetime-The date and time the user was modified
lastLogindatetime-The date and time the user last logged-in
lastFailedLogindatetime-The date and time of the last unsuccessful login attempt for the user
expirydatetimedatetimeThe expiry date for the user
passwordChangeddatetime-The date and time the user's password was last changed
optOutOfNotificationsboolean-Shows if the user has chosen to opt out of all notifications
failedLoginAttemptsintegerintegerThe total number of times this user has failed to log in. This includes entering a correct username and password on a locked account.
failedLoginAttemptsSinceLastSuccessintegerintegerThe total number of failed login attempts since the user's last successful login. This will be reset to 0 upon successful login.
successfulLoginAttemptsintegerintegerThe total number of successful login attempts by this user.

Still need help?

If you still need help after reading this article, don't hesitate to reach out to the Contensis community on Slack or raise a support ticket to get help from our team.
New support request