Setting up your Hibob integration

This feature is available to any tier of Assembled.

If you do not see this integration listed in the Integration directory, please reach out to Support.

What does it do?

The integration automatically syncs time off that’s been approved in Hibob to agent schedules in Assembled.

Details

• After a request has been approved, it will take up to 10 minutes to sync into Assembled. 
• Once an event is synced from HiBob, it won’t be editable inside of Assembled. Edits need to be made in Hibob, and those changes will sync over to Assembled.
• We only sync in contiguous time off requests. So if a single request contains multiple chunks of time, such as taking mornings off every day for a week - those events don’t sync to Assembled. Each event needs to be requested on its own to sync over.
• Morning requests are synced in as 12am-12pm and afternoon requests are synced in as 12pm-12am.

Setting up your HiBob Integration

If you're setting up a HiBob integration for the first time, you'll need to set up the integration as a Service User. This allows for a reliable, secure connection that isn't tied to a specific user's account

Previous HiBob integrations may have been set up via API key. HiBob has officially ended support for API key authentication. Any existing API-based connections should be migrated to a Service Account to ensure continued reliability.

Creating a Service User

1. Log into the Hibob app, and navigate to Settings > Integrations

2. Click on Manage Service Users

   

3. Create a new Service User. Save the Service User ID and Token for later use when connecting to Assembled

4. Navigate to Settings > Permission Groups and click Create Group

   

5. Choose a name for the group and then choose Select people by condition underneath the Group members and click Edit

   

6. Delete the pre-filled condition in the popup. Choose the Service User that you just created in the Add Specific Employees dropdown and then click Apply

   

7. Click Create in the Create Group popup. Hit confirm on the confirmation popup if one appears
8. Click on the name of the group that you just created. Navigate to the People’s data section to determine which employees this Service User will have access to.

9. Choose Select people by condition and click Edit Permissions. Select “Lifecycle status = Employed, Hired, Terminated”

   

10. Under Access Rights > Time off. Ensure that the service user has at least the permissions shown below:

    

11. Under Access Rights > Basic info. Ensure that the service user has the permission below:
    
12. Save the permissions if you had to make any changes
13. Navigate back to Assembled’s Integrations directory and click add on the Hibob card.

14. Select Service User, enter the Service User’s ID and Token in the form

    

15. Select the date that you’d like to sync data until, then click Connect with Hibob
16. The integration will show Sync in progress while it pulls in data. Once finished, it will show Connected