Articles in this section

Set up a connection to Greenhouse

Naga Sri Hari Gonaboyina
Updated

Greenhouse is a hiring and applicant-tracking platform that streamlines recruiting, manages interviews, and enhances hiring decisions through structured workflows and analytics.

Set up a connection

After you start the connection, you have to configure it in the Create connection panel and must complete all of the required * authentication settings:

Setting

Instructions

Name your connection * 

Enter a clear and distinguishable name. Throughout integrator.io imports and exports, you will have the option to choose this new connection. A unique identifier will prove helpful later when selecting it from a list of the connections in your account.

API type * 

Choose your Greenhouse API type:

  • HTTP (Harvest): Integrate with Greenhouse recruiting to fetch and manage jobs, candidates, applications, interviews, and activity logs to automate hiring workflows and sync recruiting data with other systems.

  • GraphQL (Onboarding): Query Greenhouse data with flexible, schema-driven requests to retrieve structured recruiting information efficiently and power custom dashboards, analytics, and tailored integrations.

API type: HTTP (Harvest)

API version

Select your Greenhouse API version (v1 or v3).

API key * (Only for v1 API version)

Enter the Greenhouse Harvest API key. Multiple layers of protection are in place, including AES 256 encryption, to keep your connection’s API key safe. When editing this form later, you must enter this value again; it is stored only for a saved connection.

dataLoad.svg​​ How to retrieve the API key 

User ID * (Only for v1 API version)

Enter the unique ID, available in the List Users API or the Greenhouse page source.

dataLoad.svg​​ How to retrieve the user ID 

OAuth 2.0 client * (Only for v3 API version)

Select the OAuth 2.0 client that stores the client ID and client secret provided to you by Greenhouse.

To add an OAuth 2.0 client and configure your credentials, click the plus (+) button. Click the edit (pencil.svg) button to modify a selected OAuth 2.0 client. For more information, see Create an OAuth 2.0 iClient resource.

dataLoad.svg​​ How to retrieve the client ID and client secret

API type: GraphQL (Onboarding)

Access key * 

Enter your Greenhouse access key.

dataLoad.svg​​ How to retrieve the access key 

Secret key * 

Enter your Greenhouse secret key.

Multiple layers of protection, including AES 256 encryption, are in place to keep your secret key safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text.

dataLoad.svg​​ How to retrieve the secret key

Tip

This connector documentation describes only the settings shown for the Simple view. For the corresponding HTTP/GraphQL settings, see the Basic or OAuth 2.0 auth universal connector documentation, respectively.

How to retrieve the API key

  1. Sign in to your Greenhouse account.

  2. Grant the user establishing a connection Can manage ALL organization’s API credentials privileges in the Developer permission section.

  3. Navigate to Settings > Dev center > API credential management .

  4. Click Create new API key. The Create new credentials panel appears.

  5. From the API type dropdown, select Harvest.

  6. Click Manage permissions.

  7. Copy the API key and store it in a safe place. (You will be prompted to re-enter the API key each time you edit your connection, and Greenhouse will not display it again.)

  8. Click Close. The created API key page appears.

  9. From the Manage permissions section, select the required resources.

  10. Click Save.

How to retrieve the user ID

Sign in to your Greenhouse account. The user ID is provided in the HTML page whenever you’re signed in to Greenhouse. Either of the following methods will allow you to find your unique ID:

  • View the page source in a browser tab by pressing the keys Ctrl+U (PC) or Option+⌘+U (Mac).

  • View the page source in the console inspector by right-clicking and selecting Inspect (PC) or pressing Option+⌘+J (Mac).

Then, search for the USER_ID and copy the value (Google Chrome Inspector is shown below).

greenhouse-admin-6b.png

How to retrieve the access key and secret key

  1. Sign in to your Greenhouse Onboarding super admin account.

  2. Navigate to Settings > Data flow > API management.

  3. Click Create a new API key.

  4. Enter a Name.

  5. Click Create.

  6. Copy the Access key.

  7. Copy the Secret key.

How to retrieve the client ID and client secret

  1. Sign in to your Greenhouse account.

  2. Navigate to API credentials.

  3. Click Create new API credentials.

  4. Select the Harvest V3 (OAuth) API type.

  5. Manage the required Scopes.

  6. Click Save.

  7. Copy the Client ID.

  8. Copy the Client secret.

Additional references