We have an API for user provisioning available here: https://api.appraisd.com/docs/index
Talos Perform also natively supports basic user provisioning from over 25 HRIS systems free of charge for all Talos Perform clients:
If your HRIS isn't on the list above, please use the following guidance for setting up an integration yourself. You may like to refer to this outline implementation:
For each person in your HRIS, or just for those that have been updated recently:
Sort your list of people so that managers are before their direct reports, otherwise you won't be able to assign each user a manager when you add them.
Do a GET on admin groups to get your list of admin groups and store them locally.
Do a GET "search users" to find the employee in Talos Perform using the employeeID (or email address). We suggest you set the flag to include deactivated users (see Re-hires below).
If the user does not exist:
POST to add a new user. You will need to supply their line manager's employeeID and their admin group ID. If there's an error, this could be because the manager could not be found. You can elect to send them a welcome email.
If the user already exists and the relevant properties (manager, name, email etc) are different from the ones in your records, then either:
POST the updated user in full. This will overwrite all the properties in Talos Perform with those you supply including the empty properties, so make sure you supply all the properties from the original GET otherwise they will be wiped.
or PATCH the updated user with a handful of properties. This command only overwrites the properties in Talos Perform with only those you supply. Empty or null properties are not updated in Talos Perform. This is how you can update a single property on a user (eg First Name) without affecting any other properties.
Re-hired employees
If you re-hire employees then you'll need to consider what you'd like to happen in Talos Perform. Would you like to reactivate their original profile so they can see their previous reviews and objectives (recommended)? Or would you prefer to start fresh?
In either case, note that both employee IDs and email addresses must be unique in Talos Perform, even for deactivated users. You will not be able to add a re-hired employee into Talos Perform if their email address or employee ID is already in the database under a different, original user.
So, when you 'search users' in your API implementation above, make sure you set the flag to include deactivated users in your search and depending on what you'd like to do, reactivate the original user or edit the original user's email and employee ID so that you can insert a new user.
API Tokens
To generate your token, you will need to have admin access on your Talos Perform account and then follow this link: https://app.appraisd.com/token
Tokens will have an expiry date so please make sure you make a note of this so you remember to generate a new one.