This article explains how to connect Bob / HiBob with your Pigment Workspace to retrieve any of your HiBob report data into a Pigment’s block.
 

Table of contents

As with all other native Pigment integrations, you’ll first need to configure a Connection in the integration Library page. Once configured, this connection can be used by any Application that is authorized as a data source. These authorized Apps are defined during the ‘Import Data’ configuration step. Now, let’s see how to configure and use this native integration!

Finding HiBob credentials to set up the connection

To allow Pigment to retrieve data for your HiBob account, you need to retrieve authentication information from HiBob.

Pigment supports 2 authentication methods which you can select later during the configuration of the connection. We recommend to use Service Users as a more future-proof solution, but both work well with Pigment and without any limitation.

API Token

You can retrieve an API Token following this documentation: https://apidocs.hibob.com/docs/getting-started#get-your-api-token

Before copying the Token, make sure to enable enough permissions (“Full employee read”, “Employee fields read” and “Payroll info read”) to be able to pull the correct reports. After this you may save the token to use it later in Pigment.

Service User (recommended)

You can create a Service User to allow Pigment to connect to your HiBob system. Follow this document to know how to get it: https://apidocs.hibob.com/docs/api-service-users

Setting up the HiBob Connector

Within Pigment, Navigate to the Integration page from your Workspace homepage, and click on “+ Add” on the HiBob integration

Click on “Setup a Connection” and then fill in the following 3 fields:  Name: give a name to your connection Application Access: List the application which will be allowed to use this connection Authentication mode: choose one of the two supported auth types Service User (recommended): input the User ID and User Token provided by HiBob API Token: input the API Token generated by HiBob

Load a HiBob report into Pigment

Once the HiBob Connection is configured, open any Application for which this Connection is available and open the “Import Data” interface for the object you want to import data into.  For example, if you were importing data into a Transactions, you would open up list and then select Import and Download and then Import .

Instead of “Upload file”, select the Integration option.  From here, select your HiBob Connection.

If you do not see the connection, navigate back to Integrations page, and verify that Application is on the Application Access list.

Now, you just need to add the Report ID, from HiBob, of the report you want to load into Pigment. You can find this Report ID at the end of the URL when you open that report.

Navigate to Analytics > Reports. 

Then select the report you want to load in Pigment.

The URL of this report should look like: http://app.hibob.com/reports/compagny-reports/viewer/name_of_the_report/Report_ID

The report ID is at the very end of this url and should be around 8 digit numbers long. Once you have this ID, add it in the import configuration in Pigment and click on “Start Import”.

The report data should load in Pigment within a few seconds!