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.
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
Connection Setup Guide Step-by-step instructions to connect your Humaans account to Kombo.
Sandbox Environment 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
Input Field Notes 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: Additionally, there are some optional form fields that reference: Consider enabling these in your scope configuration . 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
Manager
References /v1/hris/employees?remote_model=employee
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 Country Code
ISO country code for the remote location (e.g. US). Not required for on-site employees.
First Working Day
First day at work. Defaults to the employment start date if omitted.
Probation End Date
Must be after the start date.
Employment End Date
Must be after the first working day. Requires a leaving reason.
Working Days
List of days the employee is scheduled to work. Defaults to Monday–Friday when omitted.