Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tryrisotto.com/llms.txt

Use this file to discover all available pages before exploring further.

Connect HiBob as your HRIS to power employee self-service. Once connected, Risotto can look up employee information, retrieve PTO balances, submit time off requests, and view home addresses on file — controlled by the People Actions settings.

​
Install from the HiBob Marketplace

HiBob Settings View Risotto connects to HiBob through the HiBob Marketplace, it handles authentication and persists OAuth tokens automatically.
1

Start the install from Risotto

In the dashboard, go to Settings → People → Connect and click Install next to HiBob. You’ll be redirected to the HiBob Marketplace.
2

Approve the install in HiBob

Sign in to HiBob as an admin if prompted, then approve the requested permissions for the Risotto app. HiBob redirects you back to the dashboard once the install is complete.
3

Confirm the connection

The HiBob row in People Connect updates to show the integration is connected. A toast confirms HiBob connected successfully.
Only HiBob admins can install marketplace apps. If the Install button redirects you to HiBob without an approval screen, ask an admin in your workspace to complete the install.
A HiBob tenant can only be connected to one Risotto org at a time. If the same HiBob tenant is already connected to another Risotto org the install fails with “Please disconnect HiBob from your other Risotto org,” disconnect from the other org first, then retry the install.

​
Requested Permissions

Risotto requests the following HiBob OAuth scopes during install:
ScopePurpose
employee_data:readLook up employees and retrieve home addresses
timeoff:readRead PTO policy types, balances, and existing time off entries
timeoff:writeSubmit time off requests on behalf of the requesting employee

​
Supported Actions

HiBob supports the following People Actions:

Get Employee Info

Look up the requesting employee’s profile, title, department, work location, and start date.

Get Home Address

View the home address on file for the requesting employee.

Get PTO Balance

Retrieve balances for each policy type the employee is assigned to.

Request PTO

Submit a time off request for the requesting employee in days mode.
Update Home Address is not supported for HiBob. The HiBob public API does not expose address writes. Employee addresses can only be edited in the HiBob UI by the employee or an HR admin.

​
Terminated Employees

When HiBob marks an employee as having left the company, Risotto receives a webhook from HiBob and immediately stops People Actions from running for that employee. Requests from former employees are escalated, even if their Slack account is still active.

​
Disconnecting

To disconnect Risotto from HiBob, click Disconnect on the HiBob row in People Connect. You’ll be redirected to the HiBob Marketplace to remove the Risotto app from your workspace, which revokes the OAuth tokens.