Prerequisites

Before getting started, please carefully read the following to make sure you fulfill all requirements for the integration to work:

1. Ensure you are in Admin permission group

Your account belongs to the Admins permission group of your company's HiBob instance, or a person whose account belongs to the Admins permission group has shared their access with you. This is necessary for retrieving the API credentials, as explained later in this guide.

To verify that you have access to create API credentials:

Navigate to the top left corner. Click on the products icon
After pressing the products button, a menu will open, and you should see the System Settings option

If you cannot see the System Settings option, it means that your account does not belong to your company's Admins permission group, and you cannot complete this guide.

2. Ensure the Hiring module is enabled

Go to system modules and scroll down to Hiring and ensure that this toggle is on.

If you can't find the Hiring module in the list, you would have to reach out to HiBob support and ask them to enable it for you.

Create a new service user

Log into your HiBob instance (or that of the admin account that was shared with you)
Click on the link or follow steps 3 and 4 to go to the service user tab of your system settings
Go to System Settings > Integration Tools > Service users
Press Create Service User
Enter a display name for the service user, for example, "Acme Integration Service User" and press Create to continue
You will now be able to view the credentials of the service user.
Copy-paste them into the connection flow.

Create a permission group

Go to the permissions settings by clicking on this link, or by pressing the Go to permissions group button in the same dialog that was shown after creating the service user
Press Create permission group. A menu will open, then press Service user
Enter a Group name, i.e. "Integration service users".
In the Select service users section, search for the user that was created on the previous step. The click on Create
Press Confirm

Configuring permissions for service user

Now the connection flow will prompt you to configure the permissions

Scroll down to Hiring > Job Openings
Check on Manage all job opening
Click Save and Apply on the confirmation screen

If the permissions are not set up correctly, you will see an error screen. If this happens, make sure you followed the previous step correctly, then try again.