HR system feed #
Your HR system sends its scheduled employee export to a private SFTP drop, and the Directory stays current on its own: new hires are added, changes are applied, people who left are deactivated. No spreadsheet to upload and no identity provider in between.
It is part of the Enterprise plan and the Directory plan from 51 people, under Settings → HR System Feed. On other plans, Import on the Directory page takes the same file by hand.
When to use it #
| Your situation | Use |
|---|---|
| Your identity provider (Okta, Entra ID) already holds the employee list | SCIM provisioning |
| Your HR or payroll system can schedule a report to SFTP | HR system feed (this page) |
| You have developers and want to push changes as they happen | Directory Sync API |
| A one-time load, or a small team | Directory → Import |
It works with Paycor, ADP Workforce Now, Paylocity, Rippling, UKG Pro, Workday, Dayforce, isolved and any system that can deliver a CSV or Excel (.xlsx, .xls) export on a schedule. Some vendors (Viventium, Dayforce, isolved) set up scheduled SFTP delivery through their support team; ask them for a "scheduled report to SFTP".
Setting it up #
- Open Settings → HR System Feed and start a feed. Pick your HR system so the usual column names are recognized.
- The page shows the connection details to give your HR system: Host, Port, Username, Password and the Host key fingerprint. If your HR system prefers to hold the private key (Paylocity, Workday), add its public key instead of using the password. RSA keys must be 3072 bits or longer.
- In your HR system, schedule the employee report to that SFTP destination, daily or weekly.
- Check the column mapping on the first file: work email, first and last name are needed; birthday, hire date, department, job title, manager and status are used when present.
Until the schedule exists you can upload a file on the same page; it is imported exactly as a delivered one would be.
What an import does #
- Adds people who are new in the file and updates people whose details changed.
- Deactivates people whose status says they left and, with the feed set to Sync, people who are no longer in the file. By default only people the feed added are deactivated; people you added by hand are left alone.
- Birthdays are stored without the year. A hire date starts work-anniversary and welcome automations.
- People managed by the feed are marked in the Directory and are edited in your HR system, not by hand.
Each run is listed with what it added, changed, deactivated and skipped.
Safeguards #
- A file that would deactivate more than a set share of the Directory (20% unless you change it) is held for your approval instead of being applied, so a truncated export cannot empty it.
- You can be told when an expected file does not arrive.
- Credentials can be rotated at any time; the old ones stop working at once.
- The drop accepts uploads only. Files cannot be listed or downloaded from it, and repeated failed sign-ins lock the drop.
Related #
- Directory Sync: every way to keep the Directory current.
- Automations: birthdays, work anniversaries and welcome cards that run from it.
- Member-change webhooks fire for changes a feed makes.