HiBob integration

Use the HiBob integration to put time off approved in HiBob on team members’ schedules in Assembled automatically. You connect it with a HiBob service user, which keeps the connection working independently of any one person’s HiBob account.

To connect it, go to Configure > Third-party integrations and find the HiBob card. If you don’t see it, contact our team.

How the HiBob integration works

• Time off syncs to Assembled after it’s approved in HiBob, within about 10 minutes.
• Time off from HiBob is read-only in Assembled. Make changes in HiBob, and they sync to Assembled.
• Only continuous time off syncs. A single request for separate pieces of time, such as every morning for a week, doesn’t sync.
• To sync time off like that, request each piece of time separately.
• Half-day requests sync as fixed blocks: a morning is 12:00 AM to 12:00 PM, and an afternoon is 12:00 PM to 12:00 AM.
• Assembled needs access to each person’s ID, email, display name, and time off in HiBob.

Create a service user in HiBob

Create the service user

1. In HiBob, go to Settings > Integrations and select Manage Service Users.
2. Create a service user.
3. Save the service user’s ID and Token. You enter them in Assembled later.

Create a permission group for it

1. Go to Settings > Permission Groups and select Create Group.
2. Enter a name for the group.
3. Under Group members, choose Select people by condition, and select Edit.
4. Delete the condition that’s already filled in.
5. In Add Specific Employees, choose the service user you created, and select Apply.
6. Select Create in Create Group, and confirm if HiBob asks.

Choose whose data the service user can access

1. Open the group you created, and go to the People’s data section.
2. Choose Select people by condition and select Edit Permissions.
3. Set the condition to Lifecycle status is Employed, Hired, or Terminated.

Give the service user access rights

1. Under Access Rights > Time off, make sure the service user has at least these permissions:
   • Under Balance, See selected people’s time off and sick leave balances.
   • Under Requests, Create, edit, and cancel people’s requests that haven’t been approved yet, Edit and cancel people’s future requests that have been approved, Edit and cancel people’s past requests that have been approved, and View, approve or decline requests that are pending approval of others.
   • Under See who’s out today, See who’s out because of a private policy and See who’s out today.
2. Under Access Rights > Basic info, make sure the service user has View selected employees’ Basic info sections.
3. Save the permissions if you changed any.

Connect HiBob in Assembled

1. Go to Configure > Third-party integrations, find the HiBob card, and select Configure integration.
2. Leave Service User selected. HiBob no longer supports API key authentication, so don’t choose API Key.
3. Enter the Service User ID and Service User Token.
4. In Sync data from, choose the date to start syncing time off from.
5. Select Connect with HiBob.

While Assembled imports time off from that date, the card shows Backfill in progress. When the import finishes, it shows Backfilled until with the date reached, and when time off last synced.

To disconnect HiBob, select the card’s Edit integration menu, then Disable integration.