Connect your Gusto account in this setup, and we read your employees every few minutes.
The values in braces, such as {acs_url}, are specific to your connection. The setup link from the application you are connecting shows them with a copy button. The same steps appear there.
-
Connect Gusto
Section titled “Connect Gusto”Select Connect Gusto. A page from OhAuthCat names the organization this directory belongs to; check it, then select Continue. Sign in to Gusto as an admin of the company and allow access to read employees. You come back to this setup when Gusto is done.
Only for the
oauthsetup method.Fixes:
directory_source_oauth_state_invalid,directory_source_oauth_confirm_required -
Choose the company
Section titled “Choose the company”If your Gusto account reaches more than one company, choose the one to sync. Nothing syncs until you choose.
Only for the
oauthsetup method. -
Get an API access token
Section titled “Get an API access token”A pasted token is the older option; use Connect Gusto when you can. Get a Gusto API access token for your company that can read employees, from your Gusto developer application or partner contact.
Only for the
tokensetup method. -
Find your company ID
Section titled “Find your company ID”Find your company’s UUID in Gusto (company_uuid in the API).
Only for the
tokensetup method. -
Enter the token and company ID
Section titled “Enter the token and company ID”Enter the access token and company ID. We read your employees once to check them before saving them encrypted; if the check fails, nothing is saved.
Only for the
tokensetup method.Fixes:
directory_source_credentials_invalid,directory_source_unavailable -
Preview the first sync
Section titled “Preview the first sync”Select Preview to see who would be added, updated and removed, without changing anything.
-
Choose how often we read Gusto
Section titled “Choose how often we read Gusto”We read Gusto every 5 minutes by default. You can set any interval from 5 minutes to 24 hours. After a failure we wait longer between tries, up to an hour.
-
Know who is synced
Section titled “Know who is synced”Every sync reads every employee page. Terminated employees and people Gusto no longer returns are removed from the directory, and departments become groups.
-
Connect again if access is removed
Section titled “Connect again if access is removed”We keep the connection alive on our own. If Gusto access is revoked or refused, syncs stop with an invalid credentials error; select Connect Gusto again.
Only for the
oauthsetup method.Fixes:
directory_source_credentials_invalid,directory_source_unavailable -
Replace the token when it expires
Section titled “Replace the token when it expires”A pasted token is never refreshed. When it expires, syncs fail with an invalid credentials error; switch to Connect Gusto, or enter a new token.
Only for the
tokensetup method.
Sources
Section titled “Sources”- Authentication and authorization (Gusto), read on 2026-10-30
- Authentication (Gusto app integrations), read on 2026-10-30