Overview
For a number of HR systems, Sysarb has a dedicated integration built and maintained in direct partnership with the HR system vendor. This means the connection between your HR system and Sysarb is set up through your existing vendor contact — without the need for a third-party middleware or a manual file export.
Currently available for: Visma P, Agda, FourHuman, Fortnox
Before you begin
This guide is intended for customers who have already completed the integration assessment and confirmed that a direct API integration is the right path for their setup. If you are still exploring your options, please refer to our integration assessment guidance before proceeding.
Important — if you have existing data in Sysarb: If employee data has already been imported manually, make sure that the unique employee IDs in your HR system match those already in Sysarb. A mismatch will result in duplicate employee records. 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).
How it works
Your HR system vendor activates the Sysarb API on your instance of the HR system
The vendor generates an API key and configures the connection in Sysarb on your behalf
You review and complete the field matching in Sysarb's UI
The integration is activated and data begins syncing automatically on a schedule
The integration is owned and maintained by your HR system vendor in partnership with Sysarb. Day-to-day, the sync runs without intervention — changes in your HR system are reflected in Sysarb automatically.
Prerequisites
You have an active subscription to one of the supported HR systems listed above
The Sysarb API is available on your HR system subscription plan — confirm this with your HR system contact
You have a clear picture of which employee data fields you want to sync to Sysarb. The salary file template is available in step 2 (Select salary file) of the import flow — navigate to Import Data → File import → Preferences to reach it. To access the download, you must first complete your preferences in step 1
Setup steps
Step 1 — Contact your HR system vendor
Reach out to the contact person at your HR system vendor who manages the Sysarb integration. Let them know you want to activate the integration.
They will:
Activate the Sysarb API on your HR system instance
Generate an API key
Log in to Sysarb and enter the API key to configure the connection
When Step 1 is complete: Your HR system vendor will notify you directly. You can also confirm by navigating to Import Data → Integrations in Sysarb — the integration will appear in the list once the vendor has configured the connection and you are ready to proceed to field matching.
Step 2 — Profile
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.
Step 3 — Match fields
Once the connection is configured, navigate to Import Data → Integrations → Match fields in Sysarb.
Most standard fields are pre-matched by default. Review the table and complete any fields that are not yet matched — in particular any fields specific to your setup, such as custom fields or organisation-specific data.
A warning icon (⚠️) indicates a required field that has not yet been mapped. Work through any unmapped required fields before proceeding.
If you need guidance on which fields are required vs. recommended, refer to your salary file template or contact your Sysarb customer success contact or support.
Note: Once the integration is active, you can return to the field mapping at any time by navigating to Import Data, locating your integration, clicking the ⋮ menu, and selecting Matched fields.
Step 4 — Activate the integration
Once field matching is complete, activate the integration. Data will begin syncing on the agreed schedule.
If you are unsure whether your setup is correct before activating, contact [email protected] or your customer success contact for a review.
After activation
Once active, data from your HR system is imported to Sysarb automatically. Changes to employee records, org structure, or salary data in your HR system will be reflected in Sysarb on the next sync.
If you need to make a one-off manual import alongside the integration — for example to add data not available in the HR system — contact Sysarb support to discuss options.
Responsibilities
Activating Sysarb API on HR system | HR system vendor | Your HR system contact |
Generating API key and configuring connection | HR system vendor | Your HR system contact |
Field matching in Sysarb UI | Customer | Sysarb support or customer success |
Activating the integration | Customer | Sysarb support or customer success |
Ongoing sync and maintenance | HR system vendor + Sysarb | Sysarb support or customer success |
Troubleshooting
Integration not appearing in Sysarb | API not yet activated on HR system | Contact your HR system vendor to confirm activation |
Required field showing warning icon | Field not yet mapped | Complete field matching in Sysarb UI |
Duplicate employee records | Employee ID mismatch between HR system and existing Sysarb data | Align IDs before activating — contact Sysarb support or customer success for guidance |
Data not updating after changes in HR system | Sync delay or configuration issue | Check sync schedule; contact Sysarb support or customer success if issue persists |
Support
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.
For questions about the setup on your HR system side, contact your HR system vendor.