HR System Integrations
HR integrations enrich employee records with organizational data such as department, manager, location, and employment status. This data powers department-level reporting and targeted security policies.
Supported Platforms
| Platform | Connection Method | Data Synced |
|---|---|---|
| Workday | REST API | Employees, departments, managers, locations, status |
| BambooHR | REST API | Employees, departments, managers, hire dates |
| SAP SuccessFactors | OData API | Employees, org structure, positions |
| Rippling | REST API | Employees, departments, locations |
| Custom HRIS | SCIM 2.0 or CSV import | Employee records via standard schema |
IdP vs. HR System
If you already sync employee data from your identity provider, an HR integration is optional. HR systems provide richer organizational data (cost centers, job titles, hire dates) that enables more detailed reporting and rule targeting.
Data Mapping
TIDALBAY maps HR fields to employee attributes:
| TIDALBAY Field | HR Source Field | Required |
|---|---|---|
| Work email address | Yes | |
| First Name | First/given name | Yes |
| Last Name | Last/family name | Yes |
| Department | Department or team name | Recommended |
| Manager | Manager email or ID | Recommended |
| Location | Office location or country | Optional |
| Title | Job title | Optional |
| Status | Active/terminated/leave | Recommended |
Sync Behavior
- Initial sync: All active employees are imported on first connection
- Incremental sync: Changes are synced every 15 minutes (configurable)
- New hires: Automatically created in TIDALBAY with initial score
- Terminations: Employees marked as inactive; scores frozen
- Transfers: Department and manager changes are reflected immediately
Conflict Resolution
If employee data comes from both an IdP and an HR system, the HR system takes precedence for organizational fields (department, manager, title) while the IdP takes precedence for authentication fields (email, status).
SCIM 2.0 Integration
For HR systems not in our catalog, TIDALBAY supports SCIM 2.0 for automated user provisioning:
- Navigate to Admin → Integrations → SCIM
- Copy the SCIM endpoint URL and bearer token
- Configure your HR system to push user changes to the TIDALBAY SCIM endpoint