Connect Pigment with Greenhouse

This article explains how to connect Greenhouse to Pigment and import Offers, Jobs, Openings, and Candidates data into a Pigment Block.

Before importing Greenhouse data, you need to create a Greenhouse connection in the Integrations library. You can then make the connection available to one or more Pigment Applications.

⚠️ Important

• Only Pigment Workspace Admins can configure the Greenhouse connector. For more information, see Account Types and Management.

• A Greenhouse Site Admin must authorize the connection.

Set up the Greenhouse connection

1. In Pigment, go to Settings, then Integrations.

2. Find the Greenhouse integration and select + Add.

3. Select Setup a Connection.

4. Enter a Name for the connection.

5. Under Application Access, select the Applications that can use the connection.

6. Select Connect. You're redirected to Greenhouse to authorize Pigment.

7. Review the Greenhouse data that Pigment will be able to access.

8. In Email, enter the email address associated with your Greenhouse account.

9. Select Log in to Greenhouse. If you're not already signed in to Greenhouse, sign in to your account.

10. Follow the prompts to authorize Pigment.

11. Return to Pigment and complete the connection setup.

The Greenhouse connection is now available to the Applications selected under Application Access.

ℹ️ Note

If the connection isn't available when importing data, return to Settings, then Integrations and check that the Application is included under Application Access.

Import Greenhouse data

Open the Pigment object where you want to import the Greenhouse data and select Import.

1. Select Integration.

2. Select your Greenhouse connection.

3. Select the Data type you want to import:

   • Offers

   • Jobs

   • Openings

   • Candidates

4. Configure any additional options available for the selected Data type.

5. Select Start Import.

Import Offers

When importing Greenhouse Offers:

1. Select Offers as the Data type.

2. Select the Offer status you want to import, or select All results available regardless of status to import all available Offers.

3. Select Start Import.

Import Jobs

Select Jobs as the Data type and select Start Import.

ℹ️ Note

• Departments. Data from the first three elements is loaded into Pigment. If fewer than three elements are available, the remaining columns contain null values.

• Offices. Data from the first three elements is loaded into Pigment. If fewer than three elements are available, the remaining columns contain null values.

• Hiring Team. This field isn't loaded into Pigment.

• Primary Recruiter Name (job owner). This field isn't loaded into Pigment.

Import Openings

Select Openings as the Data type and select Start Import.

The Job ID is included in the imported data so you can map each Opening to its corresponding Job.

Custom fields associated with Openings are loaded into Pigment.

ℹ️ Note

Close reason isn't currently loaded into Pigment.

Import Candidates

Select Candidates as the Data type and select Start Import.

ℹ️ Note

Recruiter and Coordinator aren't currently loaded into Pigment.