Hibob Service User Authentication

API Service User Creation

This guide outlines how to set up a Hibob Service User to integrate with Merge.

Step 1: Create the Service User

Navigate to Settings > Integrations > Manage Service Users > New Service User

Save the Service User ID & Token. Click Done.

Step 2: Create a Permission Group

Navigate to Settings > Roles & Permissions > Add another group

Step 3: Add the Service User to the Group

Click Edit under Select Who's in the Group. Add the Service User under Add Specific Employees

Step 4: Under Manage Permissions, Other Employees add the following permissions

People:

• Address

  • View selected employees' Address sections

  • View selected employees' Address section histories

• EEO

  • View selected employees' EEO sections

• Email

  • Edit selected employees' email addresses

• Employment

  • View selected employees' Employment sections

  • View selected employees' Employment section histories

• History

  • View selected employees' profile changes history

• Home

  • View selected employees' Home sections

• Identification

  • View selected employees' Identification sections

• Lifecycle

  • View selected employees' Lifecycle sections

  • Edit selected employees' Lifecycle sections

  • View selected employees' Lifecycle section histories

• Payroll

  • View selected employees' Payroll sections

  • View selected employees' Payroll section histories

• Personal

  • View selected employees' Personal sections

  • Edit selected employee's Personal sections

• Personal Contact Details

  • View selected employees' Personal contact details sections

  • Edit selected employees' Personal contact details sections

Time off:

• Balance

  • See selected people's time off and sick leave balances

• Requests

  • Create and manage selected people's time off requests

  • View, approve or decline requests that are pending approval of others

Step 5: Add Who the Permissions Apply To

Click Select by Condition > Edit > Lifecycle Status = Employed, Hired, Terminated

Step 6: Click Save Changes > Apply