> ## Documentation Index
> Fetch the complete documentation index at: https://help.gowindmill.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gusto

> Connect Gusto to Windmill to sync employees, managers, departments, and employment data so your org chart and access controls stay accurate automatically.

## Benefits of connecting Gusto to Windmill

Connecting Gusto to Windmill keeps your employee roster and reporting structure accurate without manual updates. When Gusto is the source of truth, Windmill automatically:

* Imports new hires during scheduled syncs
* Updates manager → direct report relationships
* Reflects promotions, title changes, and department moves
* Archives employees when they leave the company

This ensures performance reviews, 1:1s, and feedback always reflect the **current team**, without HR needing to update two systems.

## Connected data

Windmill syncs the following fields from Gusto:

| Field | Description |
| - | - |
| Employee Name | Full legal name as stored in Gusto |
| Work Email | Used as the identity + login field |
| Job Title | Displays across Windmill profiles and review cycles |
| Manager Relationship | Drives org charts, 1:1s, and review assignment |
| Department / Team | Used to group employees for reviews and reporting |
| Employment Status (Active / Terminated) | Used to automatically archive employees |
| Start Date | Supports new-hire ramp reviews and onboarding flows |
| Gender | Synced if provided by Gusto |

Windmill can also sync personal email, work location, and time-off records when Gusto provides them and the connection has the required authorization.

**Windmill does not store salary, compensation, payroll, benefits, home address, Social Security Numbers, dates of birth, phone numbers, pronouns, or employment contracts as employee-profile fields.** See [Personally Identifiable Information](https://help.gowindmill.com/security/pii.md) for the canonical list.

## Permissions

The user enabling the integration must have:

* **Admin** permissions in Gusto
* Ability to access **People → Team** directory data

The integration uses Gusto’s secure OAuth connection.\
No passwords or payroll permissions are shared.

**Windmill has read-only access. It does not write back to Gusto.**

## Managing employee + manager updates

If you need to:

* Change a manager
* Update someone’s department or title
* Archive a terminated employee

> **Make the change in Gusto.**

Gusto is the **source of truth** for employee records.\
Editing a synced field directly in Windmill creates a manual override, and Gusto stops updating that field. Learn how to [manage which fields sync to each employee](https://help.gowindmill.com/org-chart/employee-field-sources.md).

## FAQs

> [accordion] How often does the sync run?
>
> Once every **24 hours**, with the option to run a manual sync from Windmill.

> [accordion] Does this affect payroll?
>
> No. Windmill does not access or modify payroll data.

> [accordion] Does the sync include contractors?
>
> Only if they appear in Gusto as active workers with a manager assigned.

> [accordion] Can we sync multiple entities or EINs?
>
> Yes — Windmill supports multi-entity Gusto setups. Contact Support to configure.

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.