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 syncs in time off that’s been approved in Hibob to agent schedules in Assembled, without any added steps on the Assembled side. That way you can keep track of agents' full schedules in one place.

Setting up an API key

Setting up a Service user

Details

Getting started

First, you’ll need to choose if you want to authenticate with an API key or an Service user:

• API key is simpler to setup, but more fragile. If the account tied to the API key is terminated, the API key will become invalid and error out the integration.
• Service user is more complicated to setup, but provides control over data access and less likely to break with changes. It is not tied to an account.

Setting up an API key

1. Log into your Hibob account and select API access from the dropdown
2. Copy the API key from this section. Make sure that it has at least the approved scopes shown below
   1. Additional scopes are fine, but these are needed for the integration to work
3. Navigate to Assembled’s Integrations directory and click Add on the Hibob card
4. Select API key on the card, then copy the token from Step 2 and paste it into the input

   

5. Select the date that you’d like to sync data until, then click Connect with Hibob

   1. The integration will show Sync in progress while it pulls in data. Once finished, it will show Connected

      

Setting up 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. Save the permissions if you had to make any changes

12. Navigate back to Assembled’s Integrations directory and click add on the Hibob card.

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

    

14. Select the date that you’d like to sync data until, then click Connect with Hibob

    1. The integration will show Sync in progress while it pulls in data. Once finished, it will show Connected

Details

After a request has been approved, it will take up to 10 minutes to sync into Assembled. Once an event is synced in from the HR platform, it won’t be editable inside of Assembled. Edits will need to be made in Hibob and changes there will sync over to Assembled.

We only sync in contiguous time off requests. So if a request is in multiple chunks, such as taking mornings off every day for a week, those events don’t sync to Assembled. Each event would need to be requested on it’s own to sync over.

Morning requests are synced in as 12am-12pm and afternoon requests are synced in as 12pm-12am.