Skip to content
English
  • There are no suggestions because the search field is empty.

Finago integration

Integrating with Finago (previously 24SevenOffice) is a simple way to import and synchronize people between your organization in Huma and your Finago account.



Table of Contents

Set up integration

Active integration

 

 

 

Finago (24SevenOffice)

Finago integration lets you connect Huma with your Finago account to easily import and synchronize employee data, saving time and keeping your HR and payroll information up to date and consistent.

  • To configure an integration in Huma, you must have a "System role with full access permissions for Organization".
  • If you are unsure which roles are required on the Finago side to complete the integration setup, please contact Finago support for guidance.

 

Multiple connections

If you need to configure multiple integration instances, follow the setup guidance provided here.

 

 

Step 1: Create an Access token Finago

  1. Open 'Settings' in the main menu
  2. Navigate to the 'Misc' tab
  3. Generate a new API key in the bottom of the page.
  4. Copy the API key to the clipboard  

24sevenOffice access token-1



 

 

Step 2: Connect Huma to Finago

  1. Login to your Huma account as administrator
  2. Go to 'Integrations' in main menu
  3. Open 'Finago'
  4. Read through the documentation
  5. Click 'Set up' in the upper right corner
  6. Choose if you want to send position data from Huma -> Finago
  7. Paste the API key you just generated from Finago and check the box to verify you have the proper authority.

 

24seven - API key

 

Step 3: Activate the integration. Synchronize users and choose how to handle conflicts or missing values

  1. After clicking 'Save' you will end up in the Synchronize users step
  2. Huma will inform you of any conflicts or inconsistency between Huma and Finago and you will have to decide how to handle conflicts and/or missing values. You can decide wether or not you want to update Finago based on values in Huma or the other way around.
  3. Click 'Next' and decide how you want to sync users between Huma and Finago.

    24seven syncronize
    • If users in Finago does not exist in Huma, you can add users to Huma
    • If users in Huma does not exist in Finago, you can add users to Finago
  4. After deciding on the above click 'Syncronize users'
  5. Huma will now start synchronizing users with Finago. You will receive an email confirming the result.

 

 

Step 4: Your connection between Huma and Finago is active 

  • Any changes made to supported fields in Huma (listed below) will be automatically updated in Finago in real-time. 

  • Please be aware that you need to sync users to get the latest changes from Finago. Changes made in Finago will not be automatically be updated in Huma. 

 

24seven - active

 

 

How to sync users

Use “Synchronize users” whenever you have updated one of the supported fields in PowerOfficeGo, or when you want to create new users. For user synchronization to work, the email address must always be identical in both systems.

  1. Go to the Finago-integration in Huma

  2. Click “Synchronize users”

  3. Follow the steps. Read more about the steps here.

 

Note

  • If you have created a user in Huma, you must perform a “Manual synchronization” to create the user in Finago through the integration.

  • If an error occurs during synchronization, you can see detailed information in the “Error log” on the Finago integration page in Huma.

  • Please be aware that you need to sync users to get the latest changes from Finago. Changes made in Finago will not be automatically be updated in Huma. 

24seven - manual sync

 

 

 

Supported fields

Huma field 24SevenOffice field
Email address* (REQUIRED) 
email

Finago requires this field’s value to be unique.

Huma requires this field’s value to be unique.
Given name* (REQUIRED) 
firstname
Family name* (REQUIRED) 
lastname
Phone number 
telefon

Huma requires this field’s value to be unique.
Employment start date 
startdate
Employment end date 
enddate
Address 
postaddress
zipcode
city
countryCode
Identifications 
internationalID.ID
internationalID.countryCode
internationalID.type

The integration can’t unset this field’s value in Finago when the value is unset in Huma.
Bank account number 
account

Must be a valid Norwegian bank account number.

account
clearingno

Must be a valid Swedish bank account number.

 

account
bic

Will be filled if the bank account number is in international format (IBAN).

 

 

FAQ: Huma to Finago position integration

📄 Learn more about how employee data synchronization works in integrations in general.

⚠️ Note that activating the integration does not transfer historical position data to Finago. Only positions that are created or updated in Huma after the integration is activated will be synchronized.

Position data is synchronized only from Huma to Finago, not from Finago to Huma.

Supported fields – position fields that are synchronized

These are the position fields that are synchronized from Huma to Finago:

Huma field Finago field
Contract type

employmentForm

This field cannot be unset in Finago
Employment percentage

employmentRate

This field cannot be unset in Finago
Contract start date

startDate

This field cannot be unset in Finago
Contract end date endDate
End reason endReason

⚠️  The integration cannot delete an employment in Finago. However, if the contract end date or end reason is unset in Huma, the corresponding value will also be unset in Finago.

⚠️  Finago allows overlapping employments. Adding a position in Huma creates a new employment in Finago. Updates are matched by start date.

Does the integration update position data?

Yes. When supported position fields are changed in Huma, the updates are automatically sent to Finago.

This includes changes such as updates to contract dates, employment rate, contract type, or end reason.

 

In which direction is data synchronized?

Position data is synchronized in one direction only:

Huma → Finago

Changes made directly in Finago will not be sent back to Huma.

 

When is position data sent to Finago?

Position data is sent to Finago when:

  • A new position is created in Huma

  • An existing position is updated in Huma

  • The change happens after the integration has been activated

 

Can historical positions be transferred?

No. The integration does not automatically transfer historical position data that existed before the integration was activated.

If historical data needs to exist in Finago, it must be entered manually or triggered by updating the position in Huma after the integration has been enabled.

 

Why aren’t all position fields synchronized?

Not all position fields can be synchronized between Huma and Finago because the two systems store and structure employment information differently. Some fields exist only in one system, or their data structures do not match directly. In other cases, limitations in the Finago API or in how data is handled in Huma prevent a full one-to-one mapping between the systems.