Keep the chart true without tending it
Connect the system that already knows who works here and the chart follows it: new starters appear, leavers come off, reporting lines move when they move. Your own edits are kept where they should be. Four HR systems and two company directories work today — this page is the whole contract, including what a directory cannot tell you.
What syncs
Five fields per person. Everything else on the chart is yours.
Name
First and last as HR holds them. A person renamed in the HR system is renamed on every chart that follows it.
Title
From the primary job. If you have set a title on the chart, your title stays: an override survives every sync until you clear it.
Department
Becomes the card colour, the same as a department typed by hand. Overrides work here too.
Manager
The reporting line. A manager the sync cannot resolve leaves the person where they are rather than moving them to the root.
Employment type
Full-time, part-time, contractor, intern. Contractors keep their card and their tag; terminated people come off the chart.
Who wins when they disagree
The rules are fixed and the same every time, so a sync is never a surprise.
- The HR system is the source of truth for those five fields, for every person it knows about.
- Except where you set a title or a department on the chart yourself. Those overrides survive every sync until you clear them.
- People the HR system has never heard of — a vacancy, an advisor, a role you are planning — are never touched.
- Someone terminated in the HR system comes off the chart. Their reports move up to their manager, the same as deleting a card by hand.
- A manager who cannot be resolved leaves the person where they are. Newcomers with nobody to report to start at the top until you place them.
- The first sync onto an existing chart matches people by name where the match is unambiguous, and adds everyone else.
- Nothing is random. The same data always produces the same chart, and a loop in the HR data cannot put a loop on the chart.
What works today
Every system here has its sync script in the repo. Five are still rolling out — switched on workspace by workspace while the first real runs happen; the tag says which.
HR and payroll systems
They know employment: who was hired when, who left, who is a contractor.
Gusto
You need an admin who can approve access in Gusto.
Manager comes from manager_uuid; title from the primary job.
BambooHRRolling out
You need an API key and your BambooHR subdomain.
Manager comes from supervisorId; "Contractor" status maps to pending on Nango's side, so contractors are kept.
Switched on workspace by workspace while the first real runs happen. Ask, and yours is next.
HiBobRolling out
You need a HiBob service user ID and token, from Integrations → Service Users.
Manager comes from the reports-to field. What syncs depends on the service user's permission group, so give it read access to People and Work.
Switched on workspace by workspace while the first real runs happen. Ask, and yours is next.
Oracle Fusion Cloud HCMRolling out
You need your REST server host, plus a username and password with the human-capital roles.
Manager and department come from the primary assignment; the connection points at your own pod, not a shared endpoint.
Switched on workspace by workspace while the first real runs happen. Ask, and yours is next.
Company directories
They know the shape of the company — names, titles, departments and who reports to whom — and nothing about employment. Every company already has one, and the reporting line is usually already filled in.
Microsoft Entra IDRolling out
You need a Microsoft 365 admin who can approve directory read access.
A company directory, not payroll: no termination dates, hire dates only where the tenant records them, and employment type only where someone fills it in. A disabled account reads as a departure. Guests, unlicensed accounts and shared mailboxes are left out.
Switched on workspace by workspace while the first real runs happen. Ask, and yours is next.
Google WorkspaceRolling out
You need a Google Workspace super admin.
A company directory, not payroll: no employment type and no dates at all. Titles, departments and the reporting line come from each user's profile, so a tenant that never filled in the manager relation has no chart to read. Suspended and archived accounts read as departures.
Switched on workspace by workspace while the first real runs happen. Ask, and yours is next.
Not connectable yet
ADP Workforce Now
Held back deliberately, not for want of a sync. ADP authenticates with mutual TLS: connecting asks for a certificate and private key that ADP issues to partner applications, not to customers, so nobody could complete the connect flow today. Nango's own employee template also drops the reporting line entirely, which would draw a flat chart. Both are fixable, in that order.
Rippling
Nango authenticates Rippling but publishes no employee sync. Needs a script written against a Rippling sandbox before it can be offered.
These two are registered here and authenticate through the same connector, which is why they are named rather than left out. Neither is offered until it works end to end.
Questions people ask
- Which HR systems work today?
- Gusto, BambooHR, HiBob, Oracle HCM, Microsoft Entra ID and Google Workspace. The first four are HR and payroll systems; the last two are company directories, which know the shape of the company but not its employment records. All of them connect through Nango, which runs the sync on its own schedule and tells us when something changed; we pull the records, apply the rules on this page, and write the result into the chart as a system actor, so anyone with it open sees the change arrive.
- What can a company directory not tell you?
- Employment. A directory knows who exists, what they are called, what they do and who they report to — which is the whole chart — but Google Workspace has no employment type and no dates at all, and Entra ID has a hire date only where the tenant records one and never a termination date. Nothing is filled in from something else: no hire date inferred from when the account was created, no office guessed from a time zone. What a directory does say is when an account is switched off, and that is treated as a departure, so the card comes off the chart. If you need contractors marked and leave tracked, connect the payroll system instead.
- Why is ADP not on the list?
- Because you could not connect it if it were. ADP authenticates with mutual TLS: making the connection needs a client certificate and private key that ADP issues to registered Marketplace partners, not to their customers, so the button would open a screen nobody can complete. The published employee sync for it also drops the reporting line, which would draw every person under nobody. Both are fixable, in that order, and neither is fixed by putting the name on this page. Rippling is a shorter story: it authenticates, but no employee sync exists for it yet.
- How often does it sync?
- Every six hours, plus whenever the HR system tells us something changed, plus whenever you press Sync in the editor. A missed webhook is covered by the six-hour pass.
- Will it overwrite the chart I have already built?
- Only the five fields above, and only for people it knows. Your layout, your dotted lines, your vacancies, your title overrides and anyone you added yourself are untouched. The first sync is the one to watch: it links people by name, and anything it could not match arrives as a new card for you to place.
- What does it cost?
- It is part of Business, $199 a year, which is also where API keys and webhooks land when they ship. There is no per-employee price.
- Do photos sync?
- Not yet. The unified employee record we read does not carry one, so photos stay something you upload on the chart. If your HR system exposes them, say so and it moves up the list.
- How do I disconnect?
- From the same Sync dialog. Disconnecting removes the connection and stops the sync; the chart stays exactly as it was at the last sync, and every card is yours to edit again.
A chart that stays right
Sync is part of Business. Build the chart first — that part is free, at any size — and connect the HR system when keeping it current stops being something anyone has time for.