> For the complete documentation index, see [llms.txt](https://support.suptask.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.suptask.com/integrations-automations-and-workflows/integration-guides/hibob.md).

# HiBob

Install Hibob integration from the Hibob marketplace

## Install Suptask from the HiBob Marketplace

Connect HiBob to Suptask in a few clicks and let AI Assistants answer employee questions from tickets

{% hint style="warning" %}
This integration is a part of AI workflows in the Custom Enterprise plan. Additional cost might apply.
{% endhint %}

Suptask is available in the HiBob Marketplace. Installing it from there connects your HiBob account to Suptask with OAuth - you sign in to HiBob and approve access, and the connection is done. There is no service user to create and no token to copy.

Once connected, the AI Assistant on an Inbox can look up employee information from HiBob directly in a ticket: who someone's manager is, which department or site they belong to, when they started, how much time off they have left, or who is out today.

**Use cases:**

* Enrich an HR or IT ticket with the requester's employee information

{% hint style="info" %}
You set up this connector in the Suptask Web App as an admin under Intelligence. Your agents and users then work with it from Slack, inside the ticket.
{% endhint %}

***

### Before you begin

You'll need:

* An **admin** role in Suptask.
* A HiBob account with the rights to install apps from the HiBob Marketplace.
* The **Inbox** you want to connect HiBob to.

What you'll do:

* Start the install from the HiBob Marketplace
* Select the Inbox and connect HiBob in Suptask
* Choose which tools your Assistant may use

***

### Step 1: Install Suptask from the HiBob Marketplace

1. In HiBob, open the **Marketplace**.
2. Find **Suptask** and click **Install**.
3. You are taken to the **Intelligence** page in the Suptask Web App. Sign in to Suptask if you aren't already.

***

### Step 2: Connect HiBob in Suptask

1. On the **Intelligence** page, select the **Inbox** you want to connect HiBob to.
2. Open **Connectors** and select **HiBob**.
3. Click **Connect**.
4. A HiBob sign-in window opens. Sign in and approve access.

When it's done, the connector status changes to **Connected**. It is now ready to be used in Suptask ticket requests automatically.

{% hint style="info" %}
Connectors are set per Inbox. To use HiBob in more than one Inbox, repeat this step for each Inbox.
{% endhint %}

***

### How to use the integration

The connector is used by the AI Assistants you set up in Suptask. Agents and users work with it in Slack, from inside the ticket.

Examples of what can be asked in a ticket thread:

```
@Suptask who is the requester's manager and which department are they in?
```

```
@Suptask which office is the requester located in? 
```

An Assistant can also run automatically when a ticket is created, for example to post the requester's department, manager and start date on every new HR ticket before an agent picks it up.

***

### How permissions work

The connector inherits the access of the HiBob account that approved the connection. It can never read more than that account is allowed to see in HiBob. The integration is restricted to read employee info.

***

### Troubleshooting

* **The install didn't land on the Intelligence page** - you may not be signed in to Suptask, or your Suptask user isn't an admin. Sign in as an admin and start the install from the HiBob Marketplace again.
* **The HiBob sign-in window closes without connecting** - the approval wasn't completed. Click **Connect** again and approve access.
* **Connected, but no data returned** - the account that approved the connection doesn't have access to the data you're asking for in HiBob.
* **Some employee fields are missing** - those fields sit in a category the approving account can't read in HiBob.
* **The connector stopped working** - the connection may have been revoked in HiBob, or the approving account was removed. Click **Connect** to authorize again.

***

### Need help?

Reach out to [Suptask Support](https://support.suptask.com/getting-started/contact-support) and our team will help you connect HiBob.