Humaans is now a native directory connector too. Paste an API access token and ShiftControl keeps your people, their departments, job titles, locations and managers in sync every hour — with leavers actually disabled instead of quietly vanishing.
Humaans lets you organise people two ways: a plain department field, or a full Org units hierarchy. We detect which one you use when you connect, and remember it. If you are on Org units with nesting, your parent departments come through and we build matching nested groups.
How It Works
- One API access token with the
private:readscope, created by an owner or admin. A token made by a regular user can only read its own profile, so we check the scope at connect time and tell you if it is too narrow. - Syncs hourly: preferred and legal names, work email, employee ID, job title, department, location, team, manager, contract type, and start and end dates.
- Offboarded people stay in the roster so they get properly disabled. Humaans hides them from its default list, which is exactly how leavers slip through unnoticed.
- New hires imported from your ATS flow in automatically once they have a work email.
- Remote workers get their city and country instead of an office they never sit in.
- We never silently flip your department model. If your setup changes, we warn you and leave the call to you.
Getting Started
- In Humaans, have an owner or admin create an API access token with the
private:readscope. - In ShiftControl, open Integrations → Directory and pick Humaans.
- Paste the token and save. We check the scope immediately and tell you if it is short.
- The first sync runs within the hour. Preview it before anything changes.
Faster-than-hourly updates via webhooks are on our list.