HiBob Integration

By integrating EdApp with your HiBob platform, onboarding employees to your training content in EdApp becomes a fully automated process.

Enabling HiBob Integration

To enable this integration, you’ll have to first create an Access Token. To generate your API token, click on your profile picture, and then select API access. Then click "Generate" button". 
Please refer to Getting Started with HiBob for additional details on generating your API token.
Once you generate the token make sure to select Full employee read and Employee fields read under approved scopes.
Once the access token is generated with the appropriate scopes enabled, copy this token to use in setting-up the HiBob integration within EdApp. To complete the set-up in EdApp please log-in to the integrations page, then choose HiBob. 
From there choose the Set Up tab and enter your HiBob access token from the step above then click 'Connect'.
Note- Here you will also have the option to send the new users a welcome email with their credentials to login to EdApp. When using Single sign on you might not want to send this email to users but rather communicate the use of EdApp via your own channels. 
 
 Lastly choose the settings tab and toggle on the 'Sync Users' option to complete the set-up.
 

Sync User Data

Mandatory fields are Email (Work email), First name, and Last name. Email will be used as the EdApp username.

EdApp Custom fields

Custom Fields can be configured in the App Settings under the 'more' tab and must be created before the dynamic user groups themselves can be set up. Users can be segmented based on the criteria the Admin adds as custom fields. This can be anything from region, job title, territory etc. More info can be found at

Address category

The employee API response includes both Zipcode and Postcode which have the same value, so you can select either one.

USA State is only for US employees. Field format is Address {name}, it can be with space, underscore or dash. i.e. Address City, Address_City, Address-city

 

Field Label

Field name 

Category in HiBob 

Address City

addresscity

Address

Address Zipcode

addresszipcode

Address

Address Postcode

addresspostcode

Address

Address Country

addresscountry

Address

Address USA state

addressusastate

Address

 
Example of Address category in HiBob 
EdApp custom fields example

Work category

There are two sections in the Work category which we will refer to as the top and bottom sections for clarity.

 
 

EdApp field prefix for the top section is “Work”, and bottom section is “Work Details”

Mandatory fields

Jot title, Department and Site will be taken for all employees from Work details (bottom section).

 

Field Label

Field name 

Category in HiBob

Work Details Job Title

workdetailsjobtitle

Work

Work Details Department

workdetailsdepartment

Work

Work Details Site

workdetailssite

Work

 
Here's what the EdApp fields would look like for this data set:

Employment

Field label Field name Category in HiBob
Employment type employmenttype Employment

HiBob custom fields

Optionally you have the ability to bring in additional fields from the Work category. If custom fields are added from the top section, then Field Label should start with “Work” and if the fields are added from the Bottom section then Field Label should start with “Work Details”.

Using the sample data above, the custom fields in the Top section are Job Type, Job Type List, DateField, NumberField, MultilistField, HierarchyListField, and CurrencyField. Here's what the EdApp fields would look like for this data set:

Employee Sync interval

Employees will be synced from HiBob to EdApp every 24 hours beginning at the time the Sync Users option was enabled.