An API is a way for another system such as your HRIS to communicate with Talos Perform over the internet.
Talos Perform has an API that is available to all customers at no extra fee. Our API follows REST principles with a JSON payload and response. The technical documentation can be found here.
Can I integrate Talos Perform with my HRIS / HRMS?
If your HRIS is not included on the help page above, read on.
If your HRIS has an API or has the capability of interacting with an API, then it's highly likely that you can sync data from your HRIS to Talos Perform.
In practice this typically means whenever you add a new employee or make a change to an employee on your HRIS, the same employee will be added or modified on Talos Perform almost instantly. This saves you the admin time of making the changes twice and helps to ensure your Talos Perform account is always up to date.
Please note that integration is not the same as Single Sign On, which allows users to log in to Talos Perform without needing a separate password .
In some cases, you may need to write a small programme to connect your HRIS with Talos Perform. Thanks to our API documentation this should be straightforward.
Less straightforward is data that relates to reviews or objectives and syncing it between the two systems - that's because this data is more complex and needs to be 'translated' to suit the target system.
What's available with the API?
At the moment, the API includes the following areas:
Activity Log
List recent actions on Talos Perform taken by your users (logged in, such as submitted a review, edited a user)
Users
Search or list your existing users
Add new users
Make changes to existing users
Deactivate users
Your account
Get a list of questions in your review forms for your account
Get a list of Administration Groups on your account
Get a list of Review Groups on your account
Get a list of Objectives templates
Reviews
Add an appraisal/review/check-in
Delete an appraisal/review/check-in
Update an appraisal/review/check-in
Get a list of appraisals/reviews/check-ins
Responses
Get all appraisal/review/check-in responses
Get the activity logs for all responses
Objectives
Get all objectives in your account (or by user)
Get all milestones/key-results attached to objectives
Get all activity logs for an objective
Recognition
Add new recognition
Delete recognition
Update recognition
Get a list of recognition
Get a specific piece of recognition
Sandbox for API testing
We are happy to provide a sandbox that can be used for API testing. If you would like one please email support@appraisd.com
Documentation
Interactive technical documentation is available here: https://api.appraisd.com/docs/index.
Please also refer to User provisioning using the Appraisd API.
Authorisation
Access to our API is gained by passing an API token in the header of your request in this format:
Authorization: Bearer {token}
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
Info: Tokens will have an expiry date so please make sure you make a note of this so you remember to generate a new one.
We often use Postman to configure and send the request to the Talos Perform API.
Note: We do not endorse or guarantee external tools.