> ## 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.

# HiBob

> Connect HiBob as your HRIS to power employee self-service

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](/dashboard/settings/people/actions) settings.

## Install from the HiBob Marketplace

<img src="https://mintcdn.com/risotto-mtje7p526we/XKm5-RjtkclUqJ_i/dashboard/images/hibob-settings.png?fit=max&auto=format&n=XKm5-RjtkclUqJ_i&q=85&s=d1f13867480c2fba92015220ac5e24e3" alt="HiBob Settings View" width="1714" height="252" data-path="dashboard/images/hibob-settings.png" />

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

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Confirm the connection">
    The HiBob row in **People Connect** updates to show the integration is connected. A toast confirms `HiBob connected successfully`.
  </Step>
</Steps>

<Note>
  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.
</Note>

<Warning>
  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.
</Warning>

## Requested Permissions

Risotto requests the following HiBob OAuth scopes during install:

| Scope                | Purpose                                                        |
| -------------------- | -------------------------------------------------------------- |
| `employee_data:read` | Look up employees and retrieve home addresses                  |
| `timeoff:read`       | Read PTO policy types, balances, and existing time off entries |
| `timeoff:write`      | Submit time off requests on behalf of the requesting employee  |

## Supported Actions

HiBob supports the following [People Actions](/dashboard/settings/people/actions):

<CardGroup cols={2}>
  <Card title="Get Employee Info" icon="id-card">
    Look up the requesting employee's profile, title, department, work location,
    and start date.
  </Card>

  <Card title="Get Home Address" icon="house">
    View the home address on file for the requesting employee.
  </Card>

  <Card title="Get PTO Balance" icon="calendar-check">
    Retrieve balances for each policy type the employee is assigned to.
  </Card>

  <Card title="Request PTO" icon="calendar-plus">
    Submit a time off request for the requesting employee in days mode.
  </Card>
</CardGroup>

<Warning>
  **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.
</Warning>

## Terminated Employees

When HiBob marks an employee as having left the company, Risotto receives a webhook from HiBob and immediately stops [People Actions](/dashboard/settings/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](https://app.hibob.com/marketplace/manage-apps) to remove the Risotto app from your workspace, which revokes the OAuth tokens.