Skip to main content

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.

​
Benefits of Connecting Justworks to Windmill

Connecting Justworks to Windmill keeps your employee roster and reporting structure aligned automatically. When Justworks is the system of record, Windmill will:
  • Import new hires as soon as they are added to Justworks
  • Update manager → direct report relationships
  • Reflect title and department updates
  • Archive employees when they leave the company
This ensures performance reviews, 1:1s, and feedback always reflect the current org, without duplicate data entry or manual cleanup.

​
Connected Data

Windmill syncs the following fields from Justworks:
FieldDescription
Employee NameFull legal name
Work EmailUsed as the identity + login field
Job TitleDisplayed across profiles and review cycles
Manager RelationshipDrives org charts and review assignments
Department / TeamUsed for grouping, permissions, and reporting
Employment Status (Active / Terminated)Automatically archives former employees
Start DateSupports onboarding and new-hire review workflows
GenderSynced if provided by Justworks
Windmill does not sync compensation, payroll, benefits, home address, Social Security Numbers, dates of birth, phone numbers, pronouns, or employment contracts. See Personally Identifiable Information for the canonical list of fields Windmill collects.

​
Permissions

To connect the integration, the user must have:
  • Justworks Admin permissions
  • Access to view the People → Team directory
The integration uses a secure OAuth token handshake.
Windmill is read-only and does not modify or write data back to Justworks.

​
Managing Employee + Manager Updates

If you need to:
  • Change someone’s manager
  • Update a department
  • Promote or change a title
  • Remove or offboard an employee
Make these changes in Justworks — not Windmill.
Justworks is treated as the source of truth.
Any updates made directly inside Windmill will be overwritten during the next sync.

​
FAQs

Automatically every 24 hours, with an option to manually refresh in Windmill.
No — Windmill never interacts with payroll or benefits data.
Only if they are listed as active workers with a manager assigned in Justworks.
Windmill will reflect the updated title and org placement automatically.