> 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.md).

# HR systems

## Why connect your HR system

* Sync time off periods to get more accurate developer effort metrics.
* Improve Swarmia's contributor data quality by syncing employee data.
* Show time off in the work log for team visibility.

## Choose how to connect

Swarmia offers two ways to bring HR data in. When a direct integration is available for your HR system, it's the best option — Swarmia connects to your provider over OAuth, with no third-party data processor in between. For everything else, Swarmia uses Merge.dev, a universal HR connector that covers a wide range of providers.

### Direct integrations

Connect Swarmia to your HR system over OAuth.

* [**BambooHR**](/settings/integrations/hr-systems/bamboohr.md)

### Through Merge.dev

[**Merge.dev**](/settings/integrations/hr-systems/merge-dev.md) is a universal HR connector that supports a wide range of providers. Use it when your HR system doesn't have a direct integration yet.

{% hint style="info" %}
HR system integrations are part of the Enterprise plan. If you're on a different plan, your CSM or account manager can enable the feature for your organization. If neither is an option, you can still get the same improvements in developer effort accuracy by [importing time off data via CSV](/settings/integrations/hr-systems/upload-time-off-data-via-csv.md) or pushing it in through the [Time off API](/settings/integrations/swarmia-apis/time-off-api.md).
{% endhint %}


---

# 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:

```
GET https://help.swarmia.com/settings/integrations/hr-systems.md?ask=<question>
```

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.