> ## 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.
# HiBob HRIS Integration
> HiBob connector for Kombo's HRIS API
The HiBob HRIS integration allows you to sync HRIS data between HiBob and your application through Kombo's unified API. The tool slug for this connector is `hibob`.
## Guides and Resources
Step-by-step instructions to connect your HiBob account to Kombo.
## General Notes
* OAuth is supported and is required to list your app on the HiBob Marketplace. You can enable OAuth in the integration Settings tab by entering your HiBob Developer Portal credentials there.
## Supported Features & Coverage
| Field | Notes |
| ------------------- | ----- |
| id | |
| remote\_id | |
| changed\_at | |
| remote\_deleted\_at | |
| name | |
| address | |
| type | |
| 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 | |
| ssn | |
| gender | |
| ethnicity | |
| marital\_status | |
| employment\_status | |
| employment\_type | |
| weekly\_hours | |
| avatar | |
| work\_location\_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 | |
| 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 | |
| start\_time | |
| end\_time | |
| amount | |
| unit | |
| status | |
| employee\_note | |
| type\_id | |
| remote\_created\_at | |
| remote\_data | |
| Field | Notes |
| ------------------- | ----- |
| id | |
| remote\_id | |
| changed\_at | |
| remote\_deleted\_at | |
| employee\_id | |
| job\_title | |
| pay\_rate | |
| pay\_period | |
| pay\_frequency | |
| employment\_type | |
| pay\_currency | |
| effective\_date | |
| remote\_data | |
| custom\_fields | |
| integration\_fields | |
| Field | Notes |
| ------------------- | ----- |
| id | |
| remote\_id | |
| changed\_at | |
| remote\_deleted\_at | |
| name | |
| type | |
| Field | Notes |
| ------------------- | ----- |
| id | |
| remote\_id | |
| changed\_at | |
| remote\_deleted\_at | |
| employee\_id | |
| type\_id | |
| balance | |
| balance\_unit | |
| used | |
| used\_unit | |
| remote\_data | |
| Field | Notes |
| ------------------- | ----- |
| id | |
| remote\_id | |
| changed\_at | |
| remote\_deleted\_at | |
| name | |
| remote\_data | |
| Field | Notes |
| ------------------- | ----- |
| employee\_id | |
| team\_id | |
| id | |
| changed\_at | |
| remote\_deleted\_at | |
Specifying absence status might not work consistently for all absence types
| Input Field | Notes |
| ----------------- | ----- |
| employee\_id | |
| absence\_type\_id | |
| status | |
| start\_date | |
| end\_date | |
| start\_half\_day | |
| end\_half\_day | |
| employee\_note | |
| Input Field | Notes |
| ----------- | ----- |
| absence\_id | |
HiBob requires a start date for the employee. If `start_date` is not provided, we will use the current date. HiBob requires a work site for the employee. We use the first one we find in the system if `location_id` is not provided in the request body
| Input Field | Notes |
| ----------------------- | ----- |
| first\_name | |
| last\_name | |
| work\_email | |
| gender | |
| job\_title | |
| home\_address.street\_1 | |
| home\_address.street\_2 | |
| home\_address.city | |
| home\_address.state | |
| home\_address.zip\_code | |
| date\_of\_birth | |
| mobile\_phone\_number | |
| 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 | |
| Input Field | Notes |
| ---------------------- | ----- |
| employee\_id | |
| category\_id | |
| document.name | |
| document.content\_type | |
| document.data\_url | |
| document.data | |
| Feature | Notes |
| --------------------- | ---------------------------------------------------- |
| Connection Guide | |
| Prerequisites | |
| Employment History | |
| OAuth | |
| API Passthrough | |
| Scope Testing | |
| Per Model Tests | |
| Per Field Tests | The individual field detection might be inconsistent |
| Delta Syncs | |
| Group Types | |
| DEPARTMENT | |
| COST\_CENTER | |
| Custom Field Explorer | |
| Employees | |
You can use the Regular API or the Hire API to create employees in HiBob. The Regular API creates employees directly in the system. With the Hire API, employees are created as new hires and need to be manually approved in HiBob's dashboard.
This integration supports multiple employee creation forms for different use cases:
**First Name**
The first name of the employee
Unified field: `first_name`
**Last Name**
The last name of the employee
Unified field: `last_name`
**Private Email**
The private email address of the employee
Unified field: `private_email`
**Work**
**Site**
The employee's site.
**Start Date**
Start date of the employee. Also considered to be the hire date
Unified field: `start_date`
**Title**
**Department**
**Manager email (reportsTo)**
Manager's email address
**Financial**
**Employment contract**
**Employment type**
**Pay period**
**Salary**
**Salary currency**
**Documents**
They will be uploaded to the employee's "Confidential" folder in HiBob.
**Custom fields**
**Text fields**
**ID**
A unique identifier of the field. Ensure this field has a unique ID to maintain data integrity.
**Display name**
The name that will be shown in Bob's UI during field mapping
**Value**
**Number fields**
**ID**
A unique identifier of the field. Ensure this field has a unique ID to maintain data integrity.
**Display name**
The name that will be shown in Bob's UI during field mapping
**Value**
**Date fields**
**ID**
A unique identifier of the field. Ensure this field has a unique ID to maintain data integrity.
**Display name**
The name that will be shown in Bob's UI during field mapping
**Value**
**Boolean fields**
**ID**
A unique identifier of the field. Ensure this field has a unique ID to maintain data integrity.
**Display name**
The name that will be shown in Bob's UI during field mapping
**Value**
**Currency fields**
**ID**
A unique identifier of the field. Ensure this field has a unique ID to maintain data integrity.
**Display name**
The name that will be shown in Bob's UI during field mapping
**Amount**
**Currency**
**Multilist fields**
**ID**
A unique identifier of the field. Ensure this field has a unique ID to maintain data integrity.
**Display name**
The name that will be shown in Bob's UI during field mapping
**Values**
**Recruiter emails**
Some **optional** form fields are referencing the following data models:
* Employees
Consider enabling these in your [scope configuration](/hris/features/scopes).
This form may contain additional custom fields that depend on your specific tool instance configuration. The exact custom fields available will vary based on your setup and cannot be displayed here.
**First Name**
The first name of the employee
Unified field: `first_name`
**Last Name**
The last name of the employee
Unified field: `last_name`
**Full name**
**Display name**
**Middle name**
**Avatar URL**
**Custom**
This object may contain additional custom fields that depend on your specific tool instance configuration. The exact custom fields available will vary based on your setup and cannot be displayed here.
**Private Email**
The private email address of the employee
Unified field: `private_email`
**ID**
References `/v1/hris/employees?remote_model=employee`
**Company id**
**Creation timestamp**
**Cover image URL**
**Financial**
**Passport number**
**National ID**
**Account name**
**Routing number**
**Account number**
**Bank name**
**Bank account type**
**Branch address**
**SWIFT code**
**IBAN**
**Sort code**
**Account type**
**Right to work closest expiry date**
**Payroll**
This object may contain additional custom fields that depend on your specific tool instance configuration. The exact custom fields available will vary based on your setup and cannot be displayed here.
**NI number**
**Employment**
**Employment effective date**
**Employment contract**
**Employment type**
**Working pattern**
**Standard working pattern**
**Full time working pattern**
**Personal working pattern**
**Hours in days not worked**
**Site working pattern**
**Actual working pattern**
**Holiday calendar ID**
**Salary pay type**
**FLSA code**
**FTE %**
**Weekly hours**
**Salary**
**Salary effective date**
**Payment**
**Base salary currency code**
**Salary pay period**
**Salary pay frequency**
**Base salary (annual)**
Unified field: `yearly_salary`
**Base salary (monthly)**
**Additional pension contribution**
**Tax code**
**Time since last salary change**
**Custom**
This object may contain additional custom fields that depend on your specific tool instance configuration. The exact custom fields available will vary based on your setup and cannot be displayed here.
**Variable**
**Variable pay Bonus Amount**
**Variable pay Bonus Pay period**
**Variable pay Bonus % company**
**Variable pay Bonus % department**
**Variable pay Bonus % individual**
**Variable pay Commission Amount**
**Variable pay Commission Pay period**
**Variable pay Commission % company**
**Variable pay Commission % department**
**Variable pay Commission % individual**
**Variable pay Executive bonus Amount**
**Variable pay Executive bonus Pay period**
**Variable pay Executive bonus % company**
**Variable pay Executive bonus % department**
**Variable pay Executive bonus % individual**
**Entitlement**
**Entitlement Childcare vouchers Monthly sum**
**Company car**
**Entitlement Company car Monthly sum**
**Entitlement Cycle to work Monthly sum**
**Entitlement Lunch vouchers Monthly sum**
**Entitlement Season ticket loans Monthly sum**
**Deduction**
**Deduction Childcare vouchers Monthly sum**
**Company car**
**Deduction Company car Monthly sum**
**Deduction Cycle to work Monthly sum**
**Deduction Lunch vouchers Monthly sum**
**Deduction Season ticket loans Monthly sum**
**Identification**
**SSN last 4 digits**
**SSN**
**Work**
This object may contain additional custom fields that depend on your specific tool instance configuration. The exact custom fields available will vary based on your setup and cannot be displayed here.
**Work effective date**
**Employee ID**
**Job title**
**Start Date**
Start date of the employee. Also considered to be the hire date
Unified field: `start_date`
**Work anniversary**
**Original start date**
**Accumulated tenure (duration)**
**Accumulated tenure (years)**
**Tenure (duration)**
**Tenure (years)**
**Work anniversary (years)**
**Site**
The employee's site.
**Site**
**Department**
**Change type**
**Reports to**
**Manager's email**
**Manager's ID**
**Manager**
References `/v1/hris/employees?remote_model=employee`
**Second level manager**
References `/v1/hris/employees?remote_model=employee`
**Is a manager**
**Number of direct reports**
**Number of direct and indirect reports**
**Tenure sum of previous lifecycle entries in days**
**Custom**
This object may contain additional custom fields that depend on your specific tool instance configuration. The exact custom fields available will vary based on your setup and cannot be displayed here.
**Work mobile**
**Work phone**
**Employee**
This object may contain additional custom fields that depend on your specific tool instance configuration. The exact custom fields available will vary based on your setup and cannot be displayed here.
**Buddy**
References `/v1/hris/employees?remote_model=employee`
**HRBP**
References `/v1/hris/employees?remote_model=employee`
**Payroll manager**
References `/v1/hris/employees?remote_model=employee`
**IT admin**
References `/v1/hris/employees?remote_model=employee`
**Org level**
**Disability status**
**Veteran status**
**Legal sex**
**Recent leave start date**
**Recent leave end date**
**Last day of work**
**Ethnicities**
**Job**
**Employee.has paid payslip**
**Repaying student or postgraduate loan type**
Field should be blank if not repaying student loans. If repaying a student loan but unsure of the plan type, select “Plan 1”.
**Personal**
**Communication**
**Slack username**
**Skype username**
**Prefix**
**Pronouns**
**Date of birth**
**Age**
**Birthday**
**Nationality**
**Address**
**Address line 1**
**Address line 2**
**Full address**
**City**
**Zip Post Postal code**
**Country**
**State Province Region**
**Site address line 1**
**Site address line 2**
**Site country**
**Site zip Post Postal code**
**Site city**
**Site state Province Region**
**Address effective date**
**Home**
**Marital status**
**Gender**
**Number of children**
**Spouse**
**Spouse's first name**
**Spouse's last name**
**Spouse's birth date**
**Spouse's birthday**
**Spouse's gender**
**Personal email**
**Personal phone**
**Personal mobile**
**About**
**Profile personalization**
**About**
**Social data**
**Social - facebook**
**Social - twitter**
**Social - linked in**
**Hobbies**
**Superpowers**
**Food preferences**
**Employment**
This object may contain additional custom fields that depend on your specific tool instance configuration. The exact custom fields available will vary based on your setup and cannot be displayed here.
**Custom**
This object may contain additional custom fields that depend on your specific tool instance configuration. The exact custom fields available will vary based on your setup and cannot be displayed here.
**Actual payment**
**Payment date**
**Payment type**
**Amount**
**Change**
**Reason**
**Changed by**
**Personal contact**
This object may contain additional custom fields that depend on your specific tool instance configuration. The exact custom fields available will vary based on your setup and cannot be displayed here.
**Custom**
This object may contain additional custom fields that depend on your specific tool instance configuration. The exact custom fields available will vary based on your setup and cannot be displayed here.
**Emergency**
**Emergency contact's first name**
**Emergency contact's middle name**
**Emergency contact's last name**
**Emergency contact relationship**
**Emergency contact's phone number**
**Emergency contact's mobile phone number**
**Emergency contact's email**
**Emergency contact's address**
**Emergency contact's city of residence**
**Emergency contact's post code**
**Emergency contact's country of residence**
**Internal**
**Lifecycle status**
**Status**
**Reason for termination**
**Termination date**
**Period since termination**
**Years since termination**
**Notice period**
**Probation end date**
**Leave and termination type**
**Current active lifecycle start date**
**State**
**Creation date**
**User data**
This object may contain additional custom fields that depend on your specific tool instance configuration. The exact custom fields available will vary based on your setup and cannot be displayed here.
**Custom**
This object may contain additional custom fields that depend on your specific tool instance configuration. The exact custom fields available will vary based on your setup and cannot be displayed here.
**Eeo**
This object may contain additional custom fields that depend on your specific tool instance configuration. The exact custom fields available will vary based on your setup and cannot be displayed here.
**Ethnicity**
**Job category**
**Custom**
This object may contain additional custom fields that depend on your specific tool instance configuration. The exact custom fields available will vary based on your setup and cannot be displayed here.
**People analytics**
**Kids risk indicator**
**Age risk indicator**
**Is manager risk indicator**
**Number of people with the same title risk indicator**
**Team size risk indicator**
**Years with current title risk indicator**
**Years with recent salary risk indicator**
**Manager tenure risk indicator**
**Number of direct reports risk indicator**
**Team recent turnover risk indicator**
**Timeoff frequency risk indicator**
**Tenure rank risk indicator**
**Recent manager change risk indicator**
**Number of 'low risk' indicators**
**Number of 'some risk' indicators**
**Number of 'at risk' indicators**
**Temporary address**
**Temporary address line 1**
**Temporary address line 2**
**Temporary city**
**Temporary state Province Region**
**Temporary country**
**Temporary zip Post Postal code**