Skip to content
Dashboard
Theme
Theme

Gusto HRIS directory sync

Set up directory sync from Gusto

View Markdown

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.

  1. 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 oauth setup method.

    Fixes: directory_source_oauth_state_invalid, directory_source_oauth_confirm_required

  2. If your Gusto account reaches more than one company, choose the one to sync. Nothing syncs until you choose.

    Only for the oauth setup method.

    Fixes: directory_source_company_required

  3. 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 token setup method.

  4. Find your company’s UUID in Gusto (company_uuid in the API).

    Only for the token setup method.

  5. 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 token setup method.

    Fixes: directory_source_credentials_invalid, directory_source_unavailable

  6. Select Preview to see who would be added, updated and removed, without changing anything.

  7. 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.

  8. Every sync reads every employee page. Terminated employees and people Gusto no longer returns are removed from the directory, and departments become groups.

  9. 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 oauth setup method.

    Fixes: directory_source_credentials_invalid, directory_source_unavailable

  10. 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 token setup method.

    Fixes: directory_source_credentials_invalid