Integrations
      Back to home
      1. Help Center
      2. Organization
      3. Integrations

      HiBob

      This article will outline our HiBob integration for user provisioning.

      Connecting Eletive to HiBob will allow for automatic provisioning of your employee data.

      Data Mapping

      Standard Fields

      The standard fields when synching users between HiBob and Eletive are shown in the table below and these will be synced automatically. The language will be set to English by default when the user is created. After that, the language can be changed within Eletive without being overwritten. 

      Field - Eletive Field - HiBob
      First name First Name
      Last name Last Name
      Email E-mail
      External Id Internal ID

       

      Note: Please note that all standard fields, First Name, Last Name and  Internal ID are mandatory to make the user syncable. Users without First Name, Last Name or Internal ID in HiBob will NOT be synced. 

      Attributes

      To sync attributes, first, create the proper attributes in Eletive, and then connect with HiBob and perform the attribute mapping. Other fields in HiBob that can be interesting to include can be Job role, Job location, Date of Birth, etc. If needed, you can read more about adding attributes and the different types of attributes in Eletive here.  As a user can belong to only one segment per attribute, field types that allow for multi-values (e.g. Multi List) are typically not compatible with Eletive. 

      To build the organizational structure in Eletive, our automatic hierarchies feature can be used. HiBob contains a field called "Manager", this can be mapped to a User type attribute in Eletive to get the organization hierarchy, as the manager field in HiBob contains a unique ID.

      Example mappings:

      Attribute - Eletive Field - HiBob 
      Manager (Needs to be created) Manager
      Date of Birth (Standard Attribute) Birth Date
      Employment Date (Standard Attribute) Hire Date
      Gender (Standard Attribute) Gender

       

      Connect

      After the proper attributes have been created in Eletive, proceed with this guide.

      HiBob 

      Disclaimer: Eletive will not cover any additional costs that may arise from your HRIS vendor enabling an integration. 

      1. Log into your HiBob account, you'll need an account with admin access
      2. Once logged in, create a Service User in order to generate a Token and Service ID. You'll find instructions of how to add a new Service User here: API Service Users.  
        Copy/Save the Token and Service ID, save this for later, you'll need to provide this information in Eletive.
      3. In Hibob you'll need to create a permission group and assign your service user to it. 
        1. When creating the permission group you set which users the service user has access rights to. This can be based on which "Lifecycle status" (such as Employed, Parental Leave, Terminated, etc.) employees have.
        2. Enable the option "View selected employee's Employment sections" under the section "People's Data/People/Employment"
        3. If synching the Date of Birth field, it is required to add the "Edit selected employees' Personal sections" option under the section "People's Data/People/Personal"
      4. Once this is done you can continue the configuration in Eletive. 

      Eletive

      1. Navigate to Settings -> Integrations -> HiBob 
        1. If this is not enabled navigate to "Settings -> Features" and turn on the "Integration" toggle 
        2. Follow up by turning on the toggle for HiBob.

      2. Add your "Token" and "Service ID", as mentioned this will be provided by when creating the Service User in HiBob 
      3. Press connect
      4. Change settings
        1. Select which "Departments" and "Employment Types" that are subject to be synched. Available Departments and Employment types will be available in a drop-down

        2. Continue to map your Eletive attributes with HiBob fields. To map a new field press "Map more fields". Available HiBob fields and Eletive attributes will also be available in a drop-down.



          Map the field "Start Date" from Hibob to your segment that represents "Employment Date/Time" in Eletive. 
      5. Once finished
        1. Press "Save & Test" to put the integration in Test Mode. This way you can view the results/effects of turning on the integration without having to enable it. 
        2. or Press "Save & Enable" to enable the integration 

      Sync intervals and information

      The sync will be performed once every hour.

      Users created by the HiBob integration will have their External Id prefixed with "hiBob-" followed by their Internal ID.