> ## Documentation Index
> Fetch the complete documentation index at: https://hub.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hibob - Service User

> Follow these steps to connect Hibob via the StackOne Hub successfully.

<Warning>
  Ensure you have Admin privileges for your Hibob account.
</Warning>

If you've been directed to StackOne to integrate with Hibob, the following steps will help you understand the process and any necessary actions to configure successful integration.

## Creating a new Service User

<Steps>
  <Step title="Navigate to Service Users">
    Using the left menu, select Settings > Integrations, select Automation under Categories. Click Manage under the Service Users Icon.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Service Users" src="https://mintcdn.com/stackone-hub/TvtHDboh-oxH0_vz/images/hibob-service-user/image1.png?fit=max&auto=format&n=TvtHDboh-oxH0_vz&q=85&s=2c78b3e25fd0677f38d9d6173947f7d5" width="2880" height="1622" data-path="images/hibob-service-user/image1.png" />
    </Frame>
  </Step>

  <Step title="Create New Service User">
    Click on the New Service User button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="New Service User" src="https://mintcdn.com/stackone-hub/TvtHDboh-oxH0_vz/images/hibob-service-user/image2.png?fit=max&auto=format&n=TvtHDboh-oxH0_vz&q=85&s=4f1b5d9917d502747519fa2d96c54244" width="2498" height="1626" data-path="images/hibob-service-user/image2.png" />
    </Frame>
  </Step>

  <Step title="Fill in Details">
    Fill in the details with relevant information and click Next.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Fill Details" src="https://mintcdn.com/stackone-hub/TvtHDboh-oxH0_vz/images/hibob-service-user/image3.png?fit=max&auto=format&n=TvtHDboh-oxH0_vz&q=85&s=1d5f14435ac88e405ff00a1f0198774c" width="1437" height="868" data-path="images/hibob-service-user/image3.png" />
    </Frame>
  </Step>

  <Step title="Copy Service User ID and Token">
    Copy Service User ID and Token to a safe place, since the token cannot be retrieved after this. However, the token can be reset and a new one created.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Service User ID and Token" src="https://mintcdn.com/stackone-hub/TvtHDboh-oxH0_vz/images/hibob-service-user/image4.png?fit=max&auto=format&n=TvtHDboh-oxH0_vz&q=85&s=3074820a0b273750ab70c8efd9dae5b7" width="711" height="539" data-path="images/hibob-service-user/image4.png" />
    </Frame>
  </Step>

  <Step title="Finish Creation">
    Click Done and the Service User is created.
  </Step>
</Steps>

## Access permissions for the Service User

The newly created Service User account has no access permissions, so you won't be able to retrieve data. Creating Permissions Groups is an additional process that is best described by Hibob:

[Creating a Custom Permissions Group](https://help.hibob.com/hc/en-us/articles/4409776408209-Create-a-custom-permission-group)

Once you have a permissions group for your service users, or already have a permissions group set up, you can add your new Service User to this group.

Ensure the following are enabled:

*In `Features` tab*

<Accordion title="People">
  <Frame>
    <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Feature permission for its People subsection" src="https://mintcdn.com/stackone-hub/TvtHDboh-oxH0_vz/images/hibob-service-user/image_features_tab.png?fit=max&auto=format&n=TvtHDboh-oxH0_vz&q=85&s=3a5110bf48c911ec5539406eff1c87c4" width="2154" height="1152" data-path="images/hibob-service-user/image_features_tab.png" />
  </Frame>

  * Directory
    * View the company's people directory
  * Employees
    * Add new people to the company
  * Organisational chart
    * Export the company's org chart
    * View the company's org chart
</Accordion>

<Accordion title="Time off">
  <Frame>
    <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Feature permission for its Time Off subsection" src="https://mintcdn.com/stackone-hub/TvtHDboh-oxH0_vz/images/hibob-service-user/image_features_time_off.png?fit=max&auto=format&n=TvtHDboh-oxH0_vz&q=85&s=21bdaca14cc22a0b9157e0952b952a21" width="808" height="814" data-path="images/hibob-service-user/image_features_time_off.png" />
  </Frame>

  * Settings
    * See company's time off settings
</Accordion>

<Accordion title="Reports">
  * Reports
    * View reports according to people's data access rights
</Accordion>

*In `People's Data` tab*

<Accordion title="People">
  <Frame>
    <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Subsectionof the people data permission" src="https://mintcdn.com/stackone-hub/TvtHDboh-oxH0_vz/images/hibob-service-user/image_people_data_tab.png?fit=max&auto=format&n=TvtHDboh-oxH0_vz&q=85&s=08e76935858300e0b0a3cec922a42090" width="2136" height="1238" data-path="images/hibob-service-user/image_people_data_tab.png" />
  </Frame>

  * About
    * Edit selected employees' About sections
    * View selected employees' About sections
  * Address
    * Edit selected employees' Address sections
    * View selected employees' Address section histories
    * View selected employees' Address sections
  * Basic info
    * Edit selected employees' Basic info sections
    * View selected employees' Basic info sections
  * EEO
    * Edit selected employees' EEO sections
    * View selected employees' EEO sections
  * Email
    * Edit selected employees' email addresses
  * Emergency
    * Edit selected employees' Emergency sections
    * View selected employees' Emergency sections
  * Employment
    * Edit selected employees' Employment sections
    * View selected employees' Employment section histories
    * View selected employees' Employment sections
  * History
    * View selected employees' profile changes history
  * Home
    * Edit selected employees' Home sections
    * View selected employees' Home sections
  * Identification
    * Edit selected employees' Identification sections
    * View selected employees' Identification section histories
    * View selected employees' Identification sections
  * Jobs
    * Edit selected employees' Jobs sections
    * View selected employees' Jobs section histories
    * View selected employees' Jobs sections
  * Lifecycle
    * Edit selected employees' Lifecycle sections
    * View selected employees' Lifecycle section histories
    * View selected employees' Lifecycle sections
  * Payroll
    * Edit selected employees' Payroll sections
    * View selected employees' Payroll section histories
    * View selected employees' Payroll sections
  * People analytics
    * View selected employees' People analytics section histories
    * View selected employees' People analytics sections
  * Personal
    * Edit selected employees' Personal sections
    * View selected employees' Personal section histories
    * View selected employees' Personal sections
  * Personal contact details
    * Edit selected employees' Personal contact details sections
    * View selected employees' Personal contact details sections
  * Training
    * Edit selected employees' Training sections
    * View selected employees' Training sections
  * User data
    * Edit selected employees' User data sections
    * View selected employees' User data sections
  * Work
    * Edit selected employees' Work sections
    * View selected employees' Work section histories
    * View selected employees' Work sections
  * Work contact details
    * Edit selected employees' Work contact details sections
    * View selected employees' Work contact details sections
  * Work eligibility
    * Edit selected employees' Work eligibility sections
    * View selected employees' Work eligibility sections
</Accordion>

<Accordion title="Documents">
  * Confidential Docs
    * Upload selected employees’ docs in the folder
    * View selected employees' docs in the folder
  * Shared Docs
    * Upload selected employees’ docs in the folder
    * View selected employees' docs in the folder
</Accordion>

<Accordion title="Time off">
  * Balance
    * Bank overtime on behalf of their employees
    * See selected people's time off and sick leave balances
  * Requests
    * View, approve or decline requests that are pending approval of others
  * See who's out today
    * See who's out today
</Accordion>

<Info>
  The permissions above do not include **Custom Fields** configured in your Account. Please make sure to grant View and/or Edit permissions for all **Custom Fields** to be included in this integration.
</Info>

<Warning>
  Required permissions may be subject to change.
</Warning>

<Steps>
  <Step title="Navigate to Permissions Groups">
    Go to Settings in the left menu and click Permissions Groups under the Account heading. Click on the group you have made for your Service Users.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Permissions Groups" src="https://mintcdn.com/stackone-hub/TvtHDboh-oxH0_vz/images/hibob-service-user/image5.png?fit=max&auto=format&n=TvtHDboh-oxH0_vz&q=85&s=a5eb428ecf10278be14a2573752551e2" width="445" height="596" data-path="images/hibob-service-user/image5.png" />
    </Frame>
  </Step>

  <Step title="Edit Permissions Group">
    In the permissions group page, click the Group Actions dropdown and select Edit Details from the list; this will open a new modal.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Edit Details" src="https://mintcdn.com/stackone-hub/TvtHDboh-oxH0_vz/images/hibob-service-user/image6.png?fit=max&auto=format&n=TvtHDboh-oxH0_vz&q=85&s=e0ea05ed5d6a6c8cfaa24baea823e459" width="484" height="416" data-path="images/hibob-service-user/image6.png" />
    </Frame>
  </Step>

  <Step title="Select People By Condition">
    If you're updating an existing Group, you may not want to change the setting in the radio button selection. But if it is a new group, click Select People By Condition; if it is already selected, continue.

    <Warning>
      If the Group Members setting is Select People by Name, you won't be able to add the Service User to this group and should create another permissions group for your Service Users.
    </Warning>

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Select People By Condition" src="https://mintcdn.com/stackone-hub/TvtHDboh-oxH0_vz/images/hibob-service-user/image7.png?fit=max&auto=format&n=TvtHDboh-oxH0_vz&q=85&s=23287390be4fc5b365cf2ff87d638d6d" width="713" height="607" data-path="images/hibob-service-user/image7.png" />
    </Frame>
  </Step>

  <Step title="Add Specific Employees">
    Once the new modal has opened titled Select People By Condition, click the dropdown under Add Specific Employees. You can select all Service Users or individually as required, then click Apply and Apply again and finally Save.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Add Specific Employees" src="https://mintcdn.com/stackone-hub/TvtHDboh-oxH0_vz/images/hibob-service-user/image8.png?fit=max&auto=format&n=TvtHDboh-oxH0_vz&q=85&s=e310565d34a2dd22d340e89c300f3279" width="714" height="553" data-path="images/hibob-service-user/image8.png" />
    </Frame>
  </Step>
</Steps>

## Link your Hibob account with StackOne

Use the Service User ID and the Service User Token generated in Step 1 to authenticate using the Service User account.

<Frame>
  <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Link Account" src="https://mintcdn.com/stackone-hub/TvtHDboh-oxH0_vz/images/hibob-service-user/image9.png?fit=max&auto=format&n=TvtHDboh-oxH0_vz&q=85&s=ce439ec9960aec72da73de95fab68db2" width="503" height="792" data-path="images/hibob-service-user/image9.png" />
</Frame>

## Configure Webhooks

To enable real-time data synchronization with time-off events, you need to configure webhooks in Hibob using the External Trigger Token provided by StackOne.

For detailed instructions on configuring webhooks, see our [Hibob Webhook Configuration Guide](/integration-configuration-concepts/hris/hibob-webhook-configurations).

### Testing Your Webhook

To check if a webhook is working correctly:

1. From the Webhooks list, locate the webhook you want to test
2. From the three-dot menu at the end of the row, select **Test**
3. The test will send a test event to the URL you provided with the "Ping test" string

<Warning>
  If the webhook test is unsuccessful (Bob did not receive a valid 200 response from your listener), the webhook will be deactivated. If this happens, fix the issue, reactivate the webhook, and try again.
</Warning>

For more details on webhook management, refer to [Hibob's Webhook Documentation](https://help.hibob.com/hc/en-us/articles/27276476753041-Manage-Webhooks).

## Useful Links

<Card title="API Reference" icon="link" href="https://apidocs.hibob.com/docs">
  [https://apidocs.hibob.com/docs](https://apidocs.hibob.com/docs)
</Card>
