# HR systems
## Why should I link my HR system with Swarmia
* Sync time off periods to get more accurate developer effort metrics.
* Enhance Swarmia’s contributor data quality by syncing employee data.
* Show time off in the work log for team visibility.
{% hint style="info" %}
If you cannot connect your HR system directly, you can also import time off data via CSV files to achieve the same improvements in developer effort accuracy.
{% endhint %}
## Connecting HR systems to Swarmia
### **Prerequisites**
* You need to be a Swarmia admin for your organization
* You need to be an admin for your HR system (See path 1) or have your HR system admin complete the setup (See path 2)
Swarmia uses [Merge.dev](http://merge.dev/) to integrate with most of the common HR systems ([see all supported systems](#supported-hr-systems)).
### **Path 1: Setting up directly**
* Navigate to Settings > [HR system](https://app.swarmia.com/settings/hr-system).
* Click *Connect* (you will need to be an admin in your HR system to complete this path).
* Select your HR system and follow the instructions provided by [Merge.dev](http://merge.dev/) to complete the integration.
* Once complete, you’ll see a Connected indicator in the Swarmia settings.
### **Path 2: Sharing the integration link with your HR admin**
* Navigate to Settings > [HR system](https://app.swarmia.com/settings/hr-system).
* Click the *Share link* below the Connect section. This will copy a unique link to your clipboard. The link expires in 7 days.
* Share the link with your HR system administrator. The page will prompt them to select your HR system and follow the instructions provided by [Merge.dev](http://merge.dev/) to complete the integration.
* Once complete, you’ll see a Connected indicator in the Swarmia settings.
## Ensuring HR system integration works
After connecting your HR system, you can verify the integration is working properly by checking the [HR system settings](https://app.swarmia.com/settings/hr-system) page. This page displays the current sync status of your HR data.
## Ensuring all your team members are linked
Once you’ve connected your HR system, Swarmia will automatically match your employees’ existing Swarmia profiles. You can navigate to [Contributors](https://app.swarmia.com/settings/contributors) under Settings > Team & Members to see how your employees have matched.
Each contributor matched with your HR system will have a corresponding logo below their name and email address.
When Swarmia isn’t entirely confident about the match, you may see suggestions to merge profiles from different systems. These suggestions will appear on the right side of the contributors table.
## Checking HR system access permissions
Before connecting the HR system, it's important to understand what data will be accessed. This guide walks you through reviewing the permissions that will be requested during the setup process.
1. Navigate to Settings > [HR system](https://app.swarmia.com/settings/hr-system).
2. Click the *Connect button.*
3. Select your HR system.
4. Click the *I am an admin* button.
5. Review requested permissions.
## Data usage
Swarmia collects only the minimum data required to enhance the developer metrics and contributor matching. Here's exactly what we collect and store from your HR system via the Merge.dev integration:
### Employee data
We collect the following fields from employee records:
* Unique identifier for the employee.
* Full name of employees for debugging purposes.
* Work email for matching with Swarmia profiles.
### Time off data
We collect the following fields from time off records:
* Status of the time off (approved, pending, etc.)
* Start date/time of the time off period.
* End date/time of the time off period.
* Reference to the employee ID.
{% hint style="info" %}
During initial setup, Swarmia syncs time-off data from the past 2 years. Ongoing updates are synced automatically.
{% endhint %}
This data is used to:
* Match employees in your HR system with contributors in Swarmia.
* Account for time off periods when calculating developer effort metrics.
* Show time off in work log (when grouped by author)
## Supported HR systems
{% hint style="info" %}
What data Swarmia can access depends on how your HR system handles permissions. Some systems give you more control than others. [Merge.dev documentation](https://help.merge.dev/en/collections/4258188-hris) provides more details on each system.
{% endhint %}
Please let us know if you do not find your HR system in the list below.
* ADP Workforce Now
* AlexisHR
* BambooHR
* Breathe
* Charlie
* Dayforce
* Factorial
* Freshteam
* Hibob
* HR Partner
* Humaans
* Justworks
* Keka
* Lucca
* Officient
* Paycor
* PeopleHR
* Personio
* Sage HR
* Sage People
* Sesame
* Square Payroll
* TriNet HR Platform
* UKG Pro Workforce Management
* [Workday](/settings/integrations/hr-systems/workday.md)
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://help.swarmia.com/settings/integrations/hr-systems.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.