> For the complete documentation index, see [llms.txt](https://help.swarmia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.swarmia.com/settings/integrations/hr-systems/merge-dev.md).
# Merge.dev
[Merge.dev](https://merge.dev/) is a universal HR connector that lets Swarmia integrate with a wide range of HR providers. Use it when your HR system doesn't have a [direct integration](/settings/integrations/hr-systems.md#direct-integrations) yet.
## Prerequisites
* You need to be a Swarmia admin for your organization.
* You need to be an admin for your HR system (path 1), or have your HR system admin complete the setup (path 2).
## Path 1: Set it up directly
* Go to **Settings** → [**HR system**](https://app.swarmia.com/settings/hr-system).
* Under *Don't see your HR system?*, click *Connect* (you'll 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](https://merge.dev/) to complete the integration.
* Once complete, you'll see a *Connected* indicator in the Swarmia settings.
## Path 2: Share the link with your HR admin
* Go to **Settings** → [**HR system**](https://app.swarmia.com/settings/hr-system).
* Click the *Share link* below the Connect section. This copies a unique link to your clipboard. The link expires in 7 days.
* Share the link with your HR system administrator. The page prompts them to select your HR system and follow the instructions provided by [Merge.dev](https://merge.dev/) to complete the integration.
* Once complete, you'll see a *Connected* indicator in the Swarmia settings.
## Check HR system access permissions
Before connecting through Merge.dev, you can review the permissions that will be requested:
1. Go to **Settings** → [**HR system**](https://app.swarmia.com/settings/hr-system).
2. Click *Connect*.
3. Select your HR system.
4. Click *I am an admin*.
5. Review the requested permissions.
## Check the integration is working
After connecting, you can verify the integration on the [HR system settings](https://app.swarmia.com/settings/hr-system) page, which shows the current sync status of your HR data.
## Make sure all team members are linked
Once you've connected your HR system, Swarmia automatically matches your employees to existing Swarmia profiles. Go 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 has 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 appear on the right side of the contributors table.
## Data usage
Swarmia collects only the minimum data required to improve developer metrics and contributor matching.
### Employee data
* Unique identifier for the employee.
* Full name (for debugging purposes).
* Work email for matching with Swarmia profiles.
### Time off data
* 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 when calculating developer effort metrics.
* Show time off in the 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 %}
Let us know if you don't find your HR system in the list below.
* ADP Workforce Now
* AlexisHR
* 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/merge-dev/workday.md)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://help.swarmia.com/settings/integrations/hr-systems/merge-dev.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.