--- title: "Connect Pigment with Greenhouse" slug: "connect-greenhouse" description: "Connect Greenhouse with Pigment to import Offers, Jobs, Openings, and Candidates data seamlessly. Learn how to set up your integration today!" tags: ["API Configuration", "Greenhouse Integration", "Importing Exporting Data", "Pigment Data Import"] updated: 2026-01-09T13:26:34Z published: 2026-01-09T13:26:34Z --- > ## Documentation Index > Fetch the complete documentation index at: https://kb.pigment.com/llms.txt > Use this file to discover all available pages before exploring further. # Connect Pigment with Greenhouse ![](https://cdn.document360.io/e47cfe35-dc28-40c7-a083-6cf003073d8e/Images/Documentation/image(19).png) This article explains how to connect Greenhouse with Pigment to retrieve Greenhouse Offers, Jobs or Openings data into a Pigment Block. 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! > [!WARNING] > **⚠️ Important** > > You need to be a [Pigment Workspace Admin](https://community.gopigment.com/getting-started-86/how-to-add-users-and-modify-account-types-in-pigment-286) to be allowed to configure the connector. > > **For Greenhouse you need these Permissions:** Basic users and above who can manage ALL organization’s API credentials ## Collecting the Greenhouse API Token to set up the connection Follow [these steps](https://support.greenhouse.io/hc/en-us/articles/5888163769883-Create-a-Harvest-API-Key-for-a-partner-integration) to generate an API key in Greenhouse for your connection. - **API Type**: *Harvest* - **Partner**: leave this dropdown blank. - **Description**: *Pigment Harvest API Key* > [!CAUTION] > **🛡️ Warning** > > This is the one and only time these API credentials will be available for viewing. Each key is unique, and for security purposes, you won’t be able to view it after it has been generated. Please store this API key in a safe place. Don’t forget to grant the following permissions to the key ([greenhouse doc](https://support.greenhouse.io/hc/en-us/articles/115000521723-Manage-Harvest-API-key-permissions)): - Offers > GET: List Offers - Jobs > GET: List Jobs - Custom Fields > GET: List Custom Fields - Candidates > GET: List Candidates ## Setting up the Greenhouse Connector 1. Once you sign into Pigment, click on **Settings** in the bottom left corner. Next, navigate to the **Integrations**page, and click on “+ Add” on the Greenhouse integration. ![](https://cdn.document360.io/e47cfe35-dc28-40c7-a083-6cf003073d8e/Images/Documentation/0c5c9ce8-0483-4529-bff4-f1f76fee8c4b.png) | 1. Click on **Setup a Connection** and then fill in the following fields: - **Name**: give a name to your connection - **Application Access**: List the application which will be allowed to use this connection - **API key**: paste the API key you generated during the previous step. 1. Click on **Setup**to finish the setup! | ![](https://cdn.document360.io/e47cfe35-dc28-40c7-a083-6cf003073d8e/Images/Documentation/35636722-8488-41a0-b1bf-d6c6f005fb3a.png) | | --- | --- | ## Load Greenhouse Offers data into Pigment Once the Greenhouse 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**. > [!WARNING] > ⚠️ Important > > To ensure optimal performance and prevent potential issues, we recommend not importing more than 90,000 elements per object such as Offers, Jobs or Candidates. Instead of “Upload file”, select the Integration option. From here, select the Greenhouse Connection you just configured. > [!NOTE] > ℹ️ **Note** > > 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 **Offers**Data Type and click on **Start Import**. You can filter on the **Offer Status**, or select **All results available regardless of status**to load all data. The data should load in Pigment within a few seconds! ## Load Greenhouse Jobs data into Pigment Follow the same steps as for **Offers** but select **Jobs**as Data type. > [!NOTE] > ℹ️ **Note** > > **How the array-type fields in the Jobs object are handled during the import into Pigment** > > `Departments`​​​: data from the first 3 elements of this array-type field will be loaded. Even if there is no data in this field, you will still see extra columns, but they will contain null data. > > `Offices`: same as `Departments `– data from the first 3 elements of this array-type field will be loaded. Even if there is no data in this field, you will still see extra columns, but they will contain null data. > > `Hiring Team`: Data from this field will not be loaded. ## Load Greenhouse Openings data into Pigment Follow the same steps as for **Offers** but select **Openings**as Data type. The Job ID is loaded here as well so you can map each opening to the job. Any custom fields in the **Openings** object will not be loaded into Pigment. ## Load Greenhouse Candidates data into Pigment Follow the same steps as for **Offers** but select **Candidates**as Data type. You can map candidates through the `candidate_id` that is loaded with Offers.