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.
This is a legacy authentication method, and it is not recommended anymore. If possible, it is recommended to use Service Users as described below.
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
Make sure your give enough permissions to your Service User for it to be able to retrieve the reports you want to use in Pigment: https://apidocs.hibob.com/docs/api-service-users#setting-access-permissions-for-service-users
Setting up the HiBob Connector
Note: you need to be a Workspace Admin to be allowed to configure the 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:
| 
|
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!