> For the complete documentation index, see [llms.txt](https://hub.equipme.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hub.equipme.io/equipme/settings-1/integrations/hr-sync-overview/connecting-your-hr-system.md).

# Connecting your HR system

With HR Sync, equipme can retrieve employee and organisational data directly from your HR system, keeping employees, groups and company structures up to date without manual maintenance.

In this article, you will learn how to set up equipme with your specific HR data source.

#### Setting up the integration <a href="#how-to-find-the-right-connection-guide" id="how-to-find-the-right-connection-guide"></a>

To set up the integration, go to **Settings → Integrations** and select the **HR Sync** tab. Find your HR system and click **Add** to set up the integration.

{% hint style="info" %}
If you cannot find your HR system, please contact us – we may already be working on an integration.
{% endhint %}

{% hint style="warning" %}
Technical identity systems such as **Microsoft Entra ID** and **Google Workspace** are always a good fallback, but we recommend connecting to your HR system if possible, as the data is usually better maintained and more organisational information is available (e.g. cost centres and department affiliations).
{% endhint %}

<figure><img src="/files/zzj9GPcGqzCkBamedFPV" alt=""><figcaption></figcaption></figure>

### **Selecting your HR system**

After selecting your HR system, a list of supported attributes will be displayed that are read by Equipme as mandatory or optional. Here you can decide which optional attributes you would like to transfer to Equipme in the future.

<p align="center"><img src="https://hub.equipme.io/~gitbook/image?url=https%3A%2F%2F1958742976-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F6ZnPz32GwgArSgb3QXCW%252Fuploads%252FLlmBKncf5XmlplSRhY26%252F2.avif%3Falt%3Dmedia%26token%3Da49c25ac-48e3-4366-80fc-81671faea2ad&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=b4ba9394&#x26;sv=2" alt=""><img src="/files/aGaTeEJZl8FhclIblQZB" alt=""></p>

After you have checked the attributes, click on **Continue**.

#### Follow the Connection Guide <a href="#how-to-find-the-right-connection-guide" id="how-to-find-the-right-connection-guide"></a>

Every of our 100+ HR system integrations is a little different, though – logins, scopes, permissions, field mapping.

To ensure a smooth setup process, equipme provides a dedicated **connection guide for each supported HR integration**. These guides explain what is required, which permissions need to be granted, and the exact steps necessary for successful synchronisation.

The connection guide can be found at the bottom of the dialogue box (see screenshot).

<figure><img src="/files/8dpMDHsVLqqYogLUR1rE" alt="" width="285"><figcaption></figcaption></figure>

#### Filter which employees are to be synchronised <a href="#how-to-find-the-right-connection-guide" id="how-to-find-the-right-connection-guide"></a>

Once the setup wizard is complete and before synchronisation begins, you can use the filter icon to control which employees are to be synchronised in Equipme based on various criteria (e.g. locations/groups).

<figure><img src="/files/iSokbfnDMGYxRBGpKPyH" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Important: Especially in very large corporate structures and depending on the HR source used, compiling the filters may take several minutes, as all data must first be read in once.
{% endhint %}

<figure><img src="/files/BgZWyPv4pB08ZhiCRlaf" alt=""><figcaption></figcaption></figure>

#### Starting the synchronization <a href="#how-to-find-the-right-connection-guide" id="how-to-find-the-right-connection-guide"></a>

Once you have completed the filtering, you can **start** (play button) the synchronization, which will automatically run every 3 hours and maintain the system entities: locations, groups, and employees.

{% hint style="warning" %}
Important: Especially in very large corporate structures and depending on the HR source used, the initial synchronisation may take several hours.
{% endhint %}

<figure><img src="/files/DvXlBBigaXdHcO8DChRW" alt=""><figcaption></figcaption></figure>


---

# 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://hub.equipme.io/equipme/settings-1/integrations/hr-sync-overview/connecting-your-hr-system.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.