This article explains how to connect 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!
Collecting the HiBob API Token to set up the connection
To allow Pigment to retrieve data for your HiBob account, you first need to generate an API key in HiBob. This must be done by a HiBob Admin, to get one click on your profile picture (top right) and select “API access”. From here, click COPY TOKEN, you will need this when establishing the connection.
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 Copy the token.
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:
- Name: give a name to your connection
- API token: paste the Access Token generated previously in HiBob.
- Application Access: List the application which will be allowed to use this connection
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:
The report ID is at the very end of this url. 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!