Skip to main content

Direct API Integration Setup Guide (Visma, P, Agda, FourHuman, Fortnox)

Written by Nina Wettergren
Updated today

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

  1. Your HR system vendor activates the Sysarb API on your instance of the HR system

  2. The vendor generates an API key and configures the connection in Sysarb on your behalf

  3. You review and complete the field matching in Sysarb's UI

  4. 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.

Did this answer your question?