How salary works in integrations

Salary sync lets Huma automatically send salary data to your payroll system when salary is created or updated.

This article explains how salary sync works across all integrations that support it.

Roles and access


Role in Huma	System role with full access to Organization
Role in payroll system	Administrator access — varies by system. See your specific integration article for details.

Which integrations support salary sync?

Salary sync is currently supported by Tripletex, Visma.net Payroll, and Unimicro. These integrations allow salary data created or updated in Huma to be automatically sent to your payroll system, so you only need to manage salary in one place.

🔗 Tripletex · Visma.net Payroll · Unimicro

How salary sync works

When salary sync is enabled, salary data created or updated in Huma is automatically sent to your payroll system. Salary flows one way only: from Huma to your payroll system. Changes made directly in your payroll system are not synced back to Huma.

What triggers a sync:

A new salary is created in Huma
An existing salary is updated in Huma
A salary is deleted in Huma

💡 Only salary created or updated in Huma after salary sync is activated is transferred. Historical salary data is not transferred automatically.

⚠️ Deleting a salary in Huma does not always delete it in your payroll system. In Tripletex, deleting a salary clears the salary values rather than removing the record. The record must be deleted manually in Tripletex. In Visma.net Payroll and Unimicro, deletions are reflected automatically.

Supported fields

Supported fields vary between integrations. Common fields include salary amount, period unit (monthly, yearly, or hourly), and start date. Some integrations also support end date and notes.

💡 The fields available depend on what your payroll system supports. See your specific integration article for the complete list of supported salary fields.

💡 In some integrations, the currency in Huma must match the currency configured in your payroll system. If they differ, the sync will fail for that salary.

How salary is matched

How salary is matched varies between integrations. In general, Huma links each salary to the correct employment record in your payroll system based on the salary period. If no matching record is found, the sync may fail or create a new record depending on the integration.

💡 If a salary sync fails, check the error log on the integration page in Huma for a specific description of what went wrong. See your specific integration article for details on how matching works.

Important to know before you start

Salary sync only applies to changes made after it is activated.
Existing salary data in Huma is not transferred automatically. Enable salary sync before you start managing salary in Huma, or update existing salaries to trigger a sync.
Salary flows one way.
Changes made in your payroll system are not reflected in Huma.
Currency must match.
The currency set on the salary in Huma must match the currency configured in your payroll system.
Overlapping salary periods are rejected.
If there are already salary records in your payroll system that overlap with the salary being sent from Huma, the sync will fail. Resolve overlapping records manually in your payroll system before retrying.
Position sync must be active.
Salary is linked to an employment period in your payroll system. If position sync is not set up correctly, salary sync may fail.

How to enable salary sync

If you did not enable salary sync during initial setup, you can turn it on at any time.

Go to your integration in Huma under Integrations
Click ··· and select "Edit connection settings"
Enable "Create salaries in integration when added in Huma"
Click "Save"

⚠️ Only salary created or updated in Huma after salary sync is activated will be transferred. Existing salary data is not transferred retroactively.

FAQ

Does salary sync transfer historical salary data?

No. Only salary created or updated in Huma after salary sync is activated is transferred. Historical salary must be entered manually in your payroll system if needed.

What happens if I delete a salary in Huma?

This depends on the integration. In Tripletex, the salary values are cleared but the record remains — you must delete it manually in Tripletex. In Visma.net Payroll and Unimicro, the salary is deleted automatically.

What happens if the currency in Huma does not match my payroll system?

The sync will fail for that salary. Check the error log on the integration page in Huma for details, and make sure the currency is consistent across both systems.

Why is my salary not showing up in my payroll system?

The most common reasons are: salary sync was not enabled when the salary was created, the currency does not match, or there are overlapping salary periods in your payroll system. Check the error log on the integration page in Huma for details.

Can I sync salary without syncing positions?

Salary is linked to an employment period in your payroll system, so position sync must be configured correctly for salary sync to work. We recommend enabling position sync before enabling salary sync.

🔗 Getting started with Payroll & accounting integrations.

🔗 How positions work in integrations.

How salary works in integrations

Introduction to salary sync between Huma and integrations.

Table of contents