Overview
Torii integrates with Humaans and syncs:
- Users, including their name, email, and employment status (active, new hire, or offboarded)
- Licenses
- Employee details: start date, termination date, teams, job title, department, and manager
- You can constantly stay updated with application information from our Integrations Page >> Integration Capabilities button >> Integration Capabilities table.
Requirements
Accounts & Permissions
- A Humaans account with the Admin role to create the API access token. (The Owner role also works, but grants more access than Torii needs.)
- A token created by a User-role account will only see that person's own profile, not the full employee list. Do not use one for this integration.
Required keys
- API Access Token: a Humaans API access token with the private:read scope.
How to Generate the Required Values
Step 1: Generate a Humaans API access token
- Sign in to Humaans as a user with the Admin role.
- Click your name in the sidebar, then select API access tokens.
- Click Generate new token.
- Enter a name for the token (for example, "Torii").
- Under scopes, select View public and private data (the
private:readscope). - Generate the token and copy it.
Important
Create the token with the minimum access Torii needs: sign in as a user with the Admin role (not a personal User-role account) unless you're already an Admin. A token created by a User role can only see that person's own profile, not the company's employee data.
How to Connect the Integration
- Go to the Integrations page in Torii.
- Search for Humaans and click Connect.
- Enter your Humaans API access token.
- Click Connect.
Update the User Lifecycle settings
To make sure you get user lifecycle information in Torii, define Humaans as your HR management system.
- Go to Settings >> Users & Employees and, under User lifecycle, click Manage sources.
- Under Human Resource Management Systems, select Humaans. If Humaans is your only source for user management, make sure the other sources are unselected.
- Click Preview changes, then Apply changes.
Additional Notes
- Job title, department, and manager are pulled from each person's job role in Humaans. If a person has no job role set, these fields will be empty in Torii.
- Only employees marked Offboarded in Humaans are marked as deleted in Torii. Employees on leave, new hires, and people with a future start date remain active.
For any further questions, please contact Torii Support.