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

# HiBob

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

## Benefits of connecting HiBob to Windmill

Connecting HiBob to Windmill keeps your employee directory and reporting structure always in sync — without manual updates. When HiBob is the system of record, Windmill automatically:

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

This ensures reviews, 1:1s, and feedback always match your actual org — no spreadsheets, no double entry.

## Connected data

Windmill syncs the following fields from HiBob:

| Field | Description |
| - | - |
| Employee Name | Full legal name |
| Work Email | Used for login + account identity |
| Job Title | Displayed in profiles and review cycles |
| Manager Relationship | Drives org structure and 1:1 pairings |
| Department / Org Unit | Used for grouping and cycle assignment |
| Employment Status (Active / Terminated) | Automatically archives former employees |
| Start Date | Supports new-hire ramp reviews and onboarding timing |
| Gender | Synced if provided by HiBob |

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

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

## Permissions

To enable the integration, the connecting user must have:

* **HiBob Admin** access
* Permission to read the **People Directory** and **Org Structure**

The connection uses a secure OAuth authorization flow.\
**Windmill never writes back to HiBob.**\
All data access is **read-only**.

## Managing employee + manager updates

If you need to:

* Change someone’s manager
* Move an employee to a new department
* Update a title
* Archive someone who has left

> **Make these updates in HiBob.**

Windmill treats HiBob as the **source of truth**.\
Editing a synced field directly in Windmill creates a manual override, and HiBob 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?
>
> Automatically **every 24 hours**, with the option to trigger a manual sync in Windmill.

> [accordion] Does this affect payroll or benefits?
>
> No — the integration is strictly **read-only**.

> [accordion] Can we sync multiple offices / locations / entities?
>
> Yes — Windmill respects HiBob's organizational structure.

> [accordion] Do contractors sync?
>
> Only if they appear in HiBob as active workers with a manager assigned.

***


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