Users

With the https://{tenant_url}/configapi/v2/user endpoint you can:

  • Create new users and define most of their attributes
  • Update existing users
  • Check and clear user lockout state
  • Manage agents' skills
  • Delete existing users

Below is a brief description of all user attributes that can be accessed via this.

  • All attributes are strings unless otherwise noted.
  • All attributes are optional unless otherwise noted.
AttributeDescription
loginIdUsername. Required to create user. Used to identify the user in all subsequent User Management API operations.
passwordPassword. Required to create user. Format must comply with security policy.
changePasswordIndicates whether user must change password on next login. Boolean. Default is false.
firstNameFirst name. Required to create user.
lastNameLast name. Required to create user.
teamTeam that the user is assigned to. Required to create user.
extensionUser's extension number. If not specified, an extension will be created and assigned automatically.
workPhoneUser's work phone number.
mobilePhoneUser's mobile phone number.
emailUser's email address.
disabledIndication whether the user account is disabled or enabled. Boolean (true/flase).
skillsFor agents an array of skills with levels (e.g., "Support": 75).
rolesAn array of user's roles (e.g., Agent).