Overview
Torii integrates with Gusto and syncs:
| User Fields | License Types |
|---|---|
| Employees of your Gusto company, including terminated employees. Synced HR fields: department, job title, manager, start date, and termination date. A user is marked as deleted only once their termination has taken effect. | Gusto |
- This integration is read-only. Torii does not make changes in Gusto.
- You can constantly stay updated with application information from our Integrations Page >> Integration Capabilities button >> Integration Capabilities table.
Requirements
Accounts & Permissions
To connect this integration, we require the following:
- A Gusto account where you are the primary admin or a full-access admin. Only these admin roles can authorize the connection.
- Each connection is linked to a single Gusto company. If you manage several Gusto companies, connect each company separately.
Scopes
Torii asks for read-only access:
- employees:read - for retrieving your employees, including terminated employees, and their HR details.
- companies:read - for identifying the Gusto company you are connecting.
How to Generate the Required Values
No API keys, client ID, or client secret are needed. Torii connects to Gusto through its own Gusto application, and you approve the access by signing in to Gusto.
Important
Sign in to Gusto with an account that is a primary admin or a full-access admin. Other roles cannot approve the connection.
How to Connect the Integration
- Go to the Integrations page in Torii.
- Search for Gusto and click Connect.
- Sign in to Gusto and, if you manage more than one company, choose the company you want to connect.
- Review the requested access and approve it. You are returned to Torii when the connection is complete.
If you do not see Gusto on the Integrations page, contact your Torii account team.
Update the User Lifecycle settings
To make sure you get user lifecycle information in Torii, define Gusto as your HR management system.
- Go to Settings >> Users & Employees and, under User lifecycle, click Manage sources.
- Under Human Resource Management Systems, select Gusto. If Gusto is your only source for user management, make sure the other sources are unselected.
- Click Preview changes, then Apply changes.
Q&A
Q: I manage more than one Gusto company. Can I connect all of them?
A: Yes. Each connection covers one Gusto company, so connect each company separately.
Q: When is a user marked as deleted?
A: Only once a termination has taken effect in Gusto. Employees who are still onboarding, or whose last day is in the future, remain active in Torii.
For any further questions, please contact Torii Support.