---
title: How to integrate with Humaans
description: A step by step guide showing how to set up an integration between Ravio and Humaans.
---
[Skip to content](https://help.ravio.com/humaans#main-content)
English
Show submenu for translations
Open main navigation
Close main navigation
- English
Show submenu for translations
- [Contact us](https://fa3fd.share-eu1.hsforms.com/2IkfMVpstTUWvffP5uESSLg)
[Contact us](https://fa3fd.share-eu1.hsforms.com/2IkfMVpstTUWvffP5uESSLg)
How can we help you?
- There are no suggestions because the search field is empty.
1. [Ravio Help Centre](https://help.ravio.com/?hsLang=en)
2. [Integrations and data sharing](https://help.ravio.com/integrations-and-data-sharing?hsLang=en)
3. [Setting up your HRIS integration](https://help.ravio.com/integrations-and-data-sharing?hsLang=en#setting-up-your-hris-integration)
# How to integrate with Humaans
## A step by step guide showing how to set up an integration between Ravio and Humaans.
### Prerequisites
Please **carefully read** the following to make sure you fulfil all the requirements to set up the integration:
- Your account is an "**Admin**".
- Confirm your account is an "**Admin**" by clicking on the 3-dot menu in the top left. You should be able to see API access tokens in the menu:
### Instructions
### **Step 1**
Log into Humaans, then click on the 3-dot menu in the top left, then on "API access tokens":
### **Step 2**
Click on "Generate new token":
### **Step 3**
Next, enter a label for the token e.g. “Ravio Integration” and select the required scopes as shown in screenshot below.
### **Step 4**
Next click on "Create access token", then "Click to copy". Make sure you copy the Token, as once you click done, there will be no way to see the details again.
🚨 **Make sure to save the token in a Notepad / offline somewhere. You can never see this token again in Humaans once you close the window.**
### Step 5
Click on *Connect your HR system* and select Humaans.
Copy and paste the API credentials that you’ve generated and paste them into your Ravio account when prompted in the integration setup. Click submit.
### **Step 6**
Congratulations, you’re all set! Last thing to do on your end is filling out the [benefits survey](https://help.ravio.com/benefits-survey-fec16705c8f24372a20449fca83ccd8b?hsLang=en) and uploading your [Levelling Framework](https://help.ravio.com/how-to-set-up-level-mapping-in-ravio?hsLang=en).
- [Getting started](https://help.ravio.com/getting-started?hsLang=en#main-content)
- [Onboarding](https://help.ravio.com/getting-started?hsLang=en#onboarding)
- [Benchmarking](https://help.ravio.com/getting-started?hsLang=en#benchmarking)
- [Pay equity](https://help.ravio.com/getting-started?hsLang=en#pay-equity)
- [Video guides](https://help.ravio.com/getting-started?hsLang=en#video-guides)
- [Using Ravio with AI tools](https://help.ravio.com/getting-started?hsLang=en#using-ravio-with-ai-tools)
- [Integrations and data sharing](https://help.ravio.com/integrations-and-data-sharing?hsLang=en#main-content)
- [Setting up your HRIS integration](https://help.ravio.com/integrations-and-data-sharing?hsLang=en#setting-up-your-hris-integration)
- [Variable and equity data](https://help.ravio.com/integrations-and-data-sharing?hsLang=en#variable-and-equity-data)
- [Manually sharing employee data](https://help.ravio.com/integrations-and-data-sharing?hsLang=en#manually-sharing-employee-data)
- [Setting up your ATS integration](https://help.ravio.com/integrations-and-data-sharing?hsLang=en#setting-up-your-ats-integration)
- [Managing your integration](https://help.ravio.com/integrations-and-data-sharing?hsLang=en#managing-your-integration)
- [Video guides](https://help.ravio.com/integrations-and-data-sharing?hsLang=en#video-guides)
- [Ravio feature guides](https://help.ravio.com/ravio-feature-guides?hsLang=en#main-content)
- [Salary bands](https://help.ravio.com/ravio-feature-guides?hsLang=en#salary-bands)
- [Explore the market](https://help.ravio.com/ravio-feature-guides?hsLang=en#explore-the-market)
- [Employee mapping & levelling](https://help.ravio.com/ravio-feature-guides?hsLang=en#employee-mapping-levelling)
- [Manage my data](https://help.ravio.com/ravio-feature-guides?hsLang=en#manage-my-data)
- [Settings](https://help.ravio.com/ravio-feature-guides?hsLang=en#settings)
- [Analyse your company](https://help.ravio.com/ravio-feature-guides?hsLang=en#analyse-your-company)
- [EU Pay Transparency](https://help.ravio.com/ravio-feature-guides?hsLang=en#eu-pay-transparency)
- [User and access management](https://help.ravio.com/user-and-access-management?hsLang=en#main-content)
- [User permissions](https://help.ravio.com/user-and-access-management?hsLang=en#user-permissions)
- [Single Sign On (SSO)](https://help.ravio.com/user-and-access-management?hsLang=en#single-sign-on-sso)
- [Benchmarking and data confidence](https://help.ravio.com/benchmarking-and-data-confidence?hsLang=en#main-content)
- [Data](https://help.ravio.com/benchmarking-and-data-confidence?hsLang=en#data)
- [Troubleshooting and support](https://help.ravio.com/troubleshooting-and-support?hsLang=en#main-content)
- [Contact support](https://help.ravio.com/troubleshooting-and-support?hsLang=en#contact-support)
- [FAQ](https://help.ravio.com/faq?hsLang=en#main-content)
- [Billing and invoices](https://help.ravio.com/faq?hsLang=en#billing-and-invoices)
- [Compliance](https://help.ravio.com/faq?hsLang=en#compliance)
- [Ravio community](https://help.ravio.com/faq?hsLang=en#ravio-community)
- [Sales](https://help.ravio.com/faq?hsLang=en#sales)
- [Integrations](https://help.ravio.com/integrations?hsLang=en)
- [Uncategorized](https://help.ravio.com/uncategorized?hsLang=en)
- Home
- Products
- Pricing
- Blog
- Company
[](http://ravio.com)
[mailto:hello@ravio.com](mailto:hello@ravio.com)
Copyright © 2026, Ravio Technologies Ltd