This guide walks through the steps required to set up a Kombo-based integration between your HR system (HRIS) and Sysarb. Kombo is a third-party integration middleware that connects directly to your HRIS via its native API, allowing employee data to sync automatically into Sysarb on a scheduled basis.

This guide is intended for customers who have already completed the integration assessment and confirmed that Kombo is the right integration path for their setup. If you are still exploring your options or have not yet completed an assessment, please refer to our integration assessment guidance before proceeding.

Important: If you already have data imported into Sysarb — for example from a manual file upload — make sure that the employee IDs in your HRIS match exactly what is already in the system. Mismatched IDs will cause duplicates. If an employee's ID changes, Sysarb will treat them as a new employee. In addition to creating a duplicate record, this will have a negative impact on historical pay equity analyses and employment record connections, as well as conversations (applicable to Pay Management clients).

Before setup can begin, confirm the following:

Note: If you are unsure which fields you need, the salary file template provides guidance through required and recommended flags, and your Sysarb customer success contact can help guide you during your implementation. We also recommend using the template as a reference sheet — noting the API field names from your HRIS alongside each Sysarb field. This will make the field matching steps in both Kombo and Sysarb significantly smoother.

The steps required to authorise Kombo to access your HRIS vary depending on which system you use. Before starting, locate the guide for your system here:

Kombo Connection Guides

Search for your HR system and review what is required before proceeding. Most systems require admin access and involve generating API credentials or authorising access via a login step.

In the Sysarb interface, navigate to Import Data via the side menu and select Integrations as your import method.

From the list of available integrations, find and select your HR system.

You will be taken to a Kombo wizard that opens within the Sysarb interface.

The wizard covers two parts:

Authentication: Connect your HRIS to Sysarb via Kombo. The exact steps depend on your HR system — refer to the connection guide you found in Step 1. In general, you will either enter API credentials generated from your HRIS, or sign in directly to your HRIS via a Kombo-provided login flow.

Field mapping: Once authenticated, Kombo maps your HRIS fields to its standardised schema before they are passed to Sysarb. The scope of this mapping depends on which fields you are using — see the Prerequisites section for guidance on field selection. Standard fields are mapped automatically; fields outside the standard scope may require manual mapping.

If you need guidance on field mapping, contact Sysarb at [email protected].

Click Authenticate to confirm the connection. If successful, you will see a confirmation before continuing.

If authentication fails, double-check the credentials and ensure the user account has the required permissions as described in your system's connection guide.

On the Profile screen, you can optionally give this integration a title — useful if you have or expect to have multiple integrations set up. This can be edited later.

Click Continue.

On the Match fields screen, you map the fields coming from your HRIS (via Kombo) to the corresponding fields in Sysarb.

Note: The data preview requires the cache layer to be loaded. If you see a "Try again later" message, use the ⋮ menu and select Refresh data. At initial setup there may be a short processing delay — this is expected. Try again after a few minutes.

Work through the list and match each field. If you need guidance on which fields are required vs. recommended, contact your Sysarb customer success contact or Sysarb support.

Once all available fields are matched, click Add integration.

Once you have completed field matching and clicked Add integration, contact your Sysarb customer success contact to initiate the test run. Sysarb will confirm that data is being received and processed correctly.

Your part in the test:

Any issues identified are resolved before the integration is marked as live.

Once you have confirmed that the test data looks correct, let your Sysarb customer success contact know. They will mark the integration as live.

Reach Sysarb at [email protected] or directly in the interface. If you are in an active implementation, your customer success contact is also available to help.