--- title: "About connecting your HRIS for Administrators - Payhawk Help Center" slug: "about-connecting-your-hris-to-payhawk" description: "Learn what to check before you connect your HR system to Payhawk: the access you grant, group or entity level setup, and syncing all employees or only a group." updated: 2026-10-22T12:45:11Z published: 2026-10-22T12:45:11Z canonical: "payhawk.com/about-connecting-your-hris-to-payhawk" --- > ## Documentation Index > Fetch the complete documentation index at: https://payhawk.com/help/llms.txt > Use this file to discover all available pages before exploring further. # About connecting your HRIS to Payhawk Before moving on to the guide for connecting Payhawk and your specific HR system, you need to consider some specifics that are valid for all HRIS integrations in Payhawk. > [!TIP] > **New HRIS connection experience (Beta)** > > A new experience when connecting your HRIS to Payhawk is now available in Payhawk Labs. For more details, see the articles on [HRIS experience revamp](/help/hris-experience-revamp). ## On granting access to Payhawk By connecting your HR system to Payhawk, you allow Payhawk to perform the following actions: - Access your HR data. - Sync employee data from your HR system. - Map companies from your HR system to your entities in Payhawk. - Map existing Payhawk users to employees in your HR system. ## Specifics - You can connect to your HR system either on a [group](/help/connecting-the-group-to-your-hr-system) or individual entity level. - Connecting Payhawk to your HRIS will automatically invite all employees from all your entities to Payhawk, unless you customize the settings. - Disconnecting the HR system will prevent further automatic synchronization of employee data between the systems. Payhawk will keep the HR data that was last synced. - To connect your HR system to Payhawk, you need to set up the authorizations for accessing and reading data. The specific actions may vary depending on your HR system. - [Full list of supported HR systems and available HR data](https://docs.merge.dev/integrations/hris/overview/) - [Prerequisites for connecting Payhawk and your HR system](/help/about-connecting-your-hris-to-payhawk#prerequisites) - [List of Payhawk guides for connecting with supported HR systems](/help/about-connecting-your-hris-to-payhawk#list-of-payhawkhris-connection-guides) ## Setting up a proper connection To establish a reliable connection, first decide whether you want to synchronize all employees or only a specific group from your HRIS system. Depending on your use case, the general approach is as described in the following sections. For the specific steps when connecting Payhawk and your HR system, refer to the [Payhawk connection guides](/help/about-connecting-your-hris-to-payhawk#list-of-payhawkhris-connection-guides). ### Syncing all employees 1. Obtain access from a user with Administrator permissions in both Payhawk and the HRIS system you intend to connect. 2. Locate your Client ID/Token or API key/Domain, depending on the HRIS system. 3. Grant Read access to the sections or attributes containing employee details such as Name, Email, Phone Number, and Company. 4. Enter the connection keys into the Payhawk setup wizard. 5. [(Group level only) Map your companies to their corresponding Payhawk entities](/help/connecting-the-group-to-your-hr-system). 6. Complete the setup process. ### Syncing a group of employees 1. Define a filtering criterion to include or exclude certain employees. 2. Create a Service User within your HRIS system. 3. Provide that Service User Read access to attributes or sections containing data about employee details such as Name, Email, Phone Number, and Company. 4. Restrict or grant access for the Service User based on your inclusion or exclusion criteria. 5. Obtain credentials from a Payhawk Admin User and the Service User created within your HRIS. 6. Locate your Client ID/Token or API key/Domain, depending on the HRIS system. 7. Enter the connection keys into the Payhawk setup wizard. 8. [(Group level only) Map your companies to their corresponding Payhawk entities](/help/connecting-the-group-to-your-hr-system). 9. Finalize your setup. ## On authorizing your HRIS account with Merge For more information on how to authenticate your HRIS account with Merge, see the [Merge HRIS **Authentication guides** help pages](https://help.merge.dev/collections/8711975283-hris). ## List of Payhawk-HRIS connection guides - [Connecting Payhawk to BambooHR](/help/connecting-payhawk-to-bamboohr) - [Connecting Payhawk to HiBob](/help/connecting-payhawk-to-your-hr-system) - [Connecting Payhawk to Microsoft Entra ID](/help/connecting-payhawk-to-microsoft-entra-id) - [Connecting Payhawk to Okta](/help/connecting-payhawk-to-okta) - [Connecting Payhawk to Personio](/help/connecting-payhawk-to-personio) ## Troubleshooting guides - [Employee filter for HR system sync with Payhawk is not working](/help/employee-filter-for-hr-system-sync-with-payhawk-is-not-working) - [Payhawk is not fetching employee data from our HR system](/help/payhawk-is-not-fetching-employee-data)