Connect Pigment with Lever

  • 20 May 2022
  • 2 replies
Connect Pigment with Lever
Userlevel 4
Badge +2

This article explains how to connect Lever with Pigment to retrieve Lever’s Requisition 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 Lever API Token to set up the connection


Go in Settings > Integrations and API > API Credentials and click on the Generate New Key button of the Lever API credentials section



Fill the following fields:

  • Key name
  • Permissions > Read Endpoints, enable the two fields
    • list requisitions
    • list requisition fields


And copy the API key.

This is the one and only time these API credentials will be available for viewing.
Please store this API key in a safe place.


Setting up the Lever Connector 


Within Pigment, navigate to the Integration page from your Workspace homepage, and click on “+ Add” on the Lever integration.

Important Note 

You need to be a Pigment Workspace Admin to be allowed to configure the connector.


Click on Setup a Connection and then fill in the following 2 fields: 

  • Name: give a name to your connection
  • Application Access: List the application which will be allowed to use this connection

Then click on Setup. It will open a popup that will request for two fields to be filled out:

  • API key: paste the API key you generated during the previous step.
  • Environment: select Production

Click on Create to finish the setup! 


Load Lever’s Requisition data into Pigment


Once the Lever Connection is configured, open an Application that the connection is available on 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 the Lever Connection you just configured.


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 select Requisition and click on Start Import.


The Lever’s Requisition data should load in Pigment within a few seconds! 

2 replies

Can this integration be bi-directional, i.e. will we also be able to write requisitions into Lever based on information in Pigment?

Userlevel 4
Badge +2

Can this integration be bi-directional, i.e. will we also be able to write requisitions into Lever based on information in Pigment?

Hello Agnar! 

For the moment this integration only allows to load Lever Requisitions into Pigment. Allowing people to push requisitions editions back into Lever is a strong candidat for H2.