Hub Docs User documentation
Back to home
Hub Docs

HR Provider Sync

What it is

HR Provider Sync keeps your employee directory in step with the system that already runs your payroll or HR. Instead of typing employees in by hand, you connect your provider once and Hub pulls the directory automatically.

The connection covers more than 200 providers, including Gusto, Rippling, ADP, BambooHR, and Workday.

When to use it

Turn on HR Provider Sync if your company already keeps employees in a payroll or HR system and you don't want to maintain a separate list inside Hub. Once connected, new hires, role changes, and contact details flow through without manual data entry.

Where to find it

In a Company Space, open Settings → Integrations. Only Company admins see this page.

How it works

Connecting

  1. From Settings → Integrations, click Connect HR provider.
  2. Hub sends you to a secure provider picker. Choose your HR system and authorize Hub.
  3. You return to Hub. The card shows Connected along with your provider's name.
  4. The first sync starts automatically and runs in the background.

Sync status

The Integrations card always tells you where the connection stands:

  • Not connected — no HR provider is linked yet.
  • Sync queued — Hub has asked the provider for the directory; results arrive shortly.
  • Connected — the badge shows the provider name and a relative timestamp like "Last synced 5 minutes ago".
  • Last sync failed — a red message explains what went wrong; click Sync now to try again.

Syncing on demand

Click Sync now to refresh the employee list immediately instead of waiting for the next scheduled run. New employees from the provider appear in the directory; existing employees pick up the latest values for any field mapped to a provider attribute.

Disconnecting

Click Disconnect to revoke Hub's access. Existing employee records stay in your directory, but they stop receiving updates from the provider until you reconnect.

Telling synced employees from manual ones

In the employee directory, every synced employee shows a Source badge. Use the Source filter at the top of the list to switch between:

  • Manual — employees you entered in Hub directly.
  • Synced from HR provider — employees brought in from your provider.

Open any synced employee to see a Sync section on their profile with the source name, the time of the last successful sync, and the provider's external ID for reference.

Mapping provider fields to your own

Hub maps the standard fields (name, email, job title, start date, gross salary, employment status) for you. To carry over additional fields from the provider — nationality, date of birth, department, work phone, or anything else specific to your setup — give the matching custom attribute a Source path that points into the provider's payload. See Custom Attributes for the form, and Adding a Custom Attribute for step-by-step instructions.

Related