> ## Documentation Index > Fetch the complete documentation index at: https://docs.kombo.dev/llms.txt > Use this file to discover all available pages before exploring further. # Humaans HRIS Integration > Humaans connector for Kombo's HRIS API The Humaans HRIS integration allows you to sync HRIS data between Humaans and your application through Kombo's unified API. The tool slug for this connector is `humaans`. ## Guides and Resources Step-by-step instructions to connect your Humaans account to Kombo. Access the Humaans sandbox environment for testing and development. ## Supported Features & Coverage | Field | Notes | | ------------------- | ----- | | id | | | remote\_id | | | changed\_at | | | remote\_deleted\_at | | | name | | | remote\_data | | | Field | Notes | | ------------------- | ----- | | id | | | remote\_id | | | changed\_at | | | remote\_deleted\_at | | | name | | | address | | | remote\_data | | | Field | Notes | | --------------------- | ----- | | id | | | remote\_id | | | changed\_at | | | remote\_deleted\_at | | | employee\_number | | | first\_name | | | last\_name | | | nationality | | | display\_full\_name | | | job\_title | | | work\_email | | | personal\_email | | | mobile\_phone\_number | | | tax\_id | | | gender | | | employment\_status | | | employment\_type | | | work\_location\_id | | | legal\_entity\_id | | | manager\_id | | | home\_address | | | bank\_accounts | | | date\_of\_birth | | | start\_date | | | termination\_date | | | remote\_created\_at | | | custom\_fields | | | integration\_fields | | | remote\_data | | | Field | Notes | | --------------------- | ----- | | id | | | remote\_id | | | changed\_at | | | remote\_deleted\_at | | | name | | | unit | | | half\_days\_supported | | | remote\_data | | | Field | Notes | | ------------------- | ----- | | id | | | remote\_id | | | changed\_at | | | remote\_deleted\_at | | | employee\_id | | | approver\_id | | | start\_date | | | end\_date | | | start\_half\_day | | | end\_half\_day | | | amount | | | unit | | | status | | | employee\_note | | | type\_id | | | remote\_data | | | Field | Notes | | ------------------- | ----- | | id | | | remote\_id | | | changed\_at | | | remote\_deleted\_at | | | employee\_id | | | job\_title | | | pay\_rate | | | pay\_period | | | employment\_type | | | pay\_currency | | | effective\_date | | | remote\_data | | | Field | Notes | | ------------------- | ----- | | id | | | remote\_id | | | changed\_at | | | remote\_deleted\_at | | | name | | | type | | | remote\_data | | | Field | Notes | | ------------------- | ----- | | id | | | remote\_id | | | changed\_at | | | remote\_deleted\_at | | | employee\_id | | | type\_id | | | balance | | | balance\_unit | | | used | | | used\_unit | | | remote\_data | | | Field | Notes | | ------------------- | ----- | | employee\_id | | | team\_id | | | id | | | changed\_at | | | remote\_deleted\_at | | Humaans requires a location to be set for the employee. We set it to to the first location in the system by default. You can change it by setting the `location_id` the request body. | Input Field | Notes | | ----------------------- | ----- | | first\_name | | | last\_name | | | work\_email | | | gender | | | job\_title | | | home\_address.street\_1 | | | home\_address.city | | | home\_address.state | | | home\_address.zip\_code | | | home\_address.country | | | date\_of\_birth | | | mobile\_phone\_number | | | nationality | | | start\_date | | | location\_id | | For detailed information about [creating employees with form](/hris/implementation-guide/create-employee), please see the [**Create Employee with Form** tab](#create-employee-with-form) above. | Input Field | Notes | | -------------------- | ----- | | staffing\_entity\_id | | | properties | | | Feature | Notes | | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Connection Guide | | | Prerequisites | | | Create credentials | | | API Passthrough | | | Scope Testing | | | Per Model Tests | | | Per Field Tests | The Humaans API returns null values both if the API does not have permissions to access the field, and if the field simply does not have a value. The permission test therefore only checks for the presence of very common fields (e.g. birthday) where it is safe to assume that a null value is due to lack of permissions rather than due to a value not being set. | | Group Types | | | TEAM | | | DEPARTMENT | | Employment end date requires a leaving reason. Some **required** form fields are referencing the following data models: * Locations Additionally, there are some **optional** form fields that reference: * Employees Consider enabling these in your [scope configuration](/hris/features/scopes). **Work Email**
Work email address for the employee. Must be unique in Humaans.
Unified field: `work_email` **First Name**
The first name of the employee
Unified field: `first_name` **Last Name**
The last name of the employee
Unified field: `last_name` **Location**
The Kombo ID of the location the employee should be in
Unified field: `location_id`
References `/v1/hris/locations?remote_model=location` **Start Date**
Start date of the employee. Also considered to be the hire date
Unified field: `start_date` **Job Role** **Job Title**
The title of the position this person is working in
Unified field: `job_title` **Department** **Manager**
References `/v1/hris/employees?remote_model=employee` **Middle Name** **Preferred Name** **Pronouns** **Gender**
The gender of the employee
Unified field: `gender` **Date of Birth**
The employee's date of birth
Unified field: `date_of_birth` **Hide Birthday**
If enabled, the birthday will be hidden from others. **Private Email**
The private email address of the employee
Unified field: `private_email` **Mobile Phone Number**
The mobile phone number of the employee
Unified field: `mobile_phone_number` **Home Phone Number**
The home phone number of the employee
Unified field: `home_phone_number` **Hide Work Email**
If enabled, hides the work email inside Humaans. **Street 1**
The street address of the employee
Unified field: `home_address.street_1` **City**
The city of the employee
Unified field: `home_address.city` **State**
The state of the employee
Unified field: `home_address.state` **ZIP Code**
The ZIP code of the employee
Unified field: `home_address.zip_code` **Country**
ISO country code (e.g. US, GB).
Unified field: `home_address.country` **Remote City** **Remote Country Code**
ISO country code for the remote location (e.g. US). Not required for on-site employees. **Nationality** **Spoken Languages** **Food Allergies** **Bio** **LinkedIn** **Twitter** **GitHub** **First Working Day**
First day at work. Defaults to the employment start date if omitted. **Probation End Date**
Must be after the start date. **Employee ID** **Contract Type** **Employment End Date**
Must be after the first working day. Requires a leaving reason. **Leaving Reason** **Leaving Note** **Tax ID** **Tax Code** **Payroll Provider** **Working Days**
List of days the employee is scheduled to work. Defaults to Monday–Friday when omitted. **Day** **Teams** **Team Name**