Read-only employee directory sync from BambooHR through a one-click OAuth connection.
Last verified against our product: October 4, 2026
Availability
Available in the admin console
How an admin connects it
OAuth Connect button. No API key to copy or paste.
Who can set it up: Organization admin (and a BambooHR admin able to approve the app).
In the Mucho Gusto admin console, open the BambooHR card and enter your BambooHR subdomain (the part before .bamboohr.com).
Click Connect. You are sent to BambooHR's own consent screen.
Approve the request in BambooHR. You are returned to the admin console and the first sync runs.
Permissions requested
Permission or scope
What it allows
employee_directory
Read the employee directory.
offline_access
Keep the connection alive between syncs by using a refresh token, so you do not have to re-approve.
Data we read
Read
Work email
First, last and preferred name
Job title
Department
Reports-to (resolved to the manager's work email)
Hire date
Termination date
Employment status
Not read
Compensation, bonuses or pay-related fields
Government identifiers (SSN, tax ID, passport)
Date of birth
Home address or personal phone number
Bank or benefits information
Performance reviews or time-off records
The sync asks BambooHR for exactly the fields above. Employees with no work email are skipped. If BambooHR withholds a field the approving admin cannot see, we simply do not receive it.
How the data is used
Seeds and refreshes your organization's org chart: job title, department and reporting line.
Records hire and termination dates so tenure and new-hire cohorts in the Connection Score are accurate.
Matches directory people to existing members by lowercased email address. A manager you have set by hand is never overwritten by a sync.
A sync never deactivates a seat or deletes a member account. Someone who disappears from the directory is marked as terminated in the employment history only.
Sync frequency
Automatically once a day (04:00 UTC), plus on demand with the admin console's sync button.
Disconnecting and purging data
How: Admin console, BambooHR card, Disconnect.
Our stored BambooHR connection (subdomain and refresh token) is deleted.
Nightly syncs for your organization stop.
Disconnecting removes our stored connection. We do not call the vendor to revoke the grant, so also revoke Mucho Gusto's access inside the vendor's own admin settings.
What remains: Disconnecting removes the stored connection only. Org-chart entries, titles, reporting lines and employment dates already imported stay in your organization's workspace, and member accounts are not deleted. To have previously synced data removed as well, email [email protected] and we will handle it case by case; there is no self-service purge today.