Skip to main content
All CollectionsSystem Setup Guides
Greenhouse Connector Setup
Greenhouse Connector Setup
Updated over 5 months ago

Authenticating Greenhouse with Savant

Connecting Savant to Greenhouse requires an API Key generated by Greenhouse itself. In order to generate an API Key, a user must have all available permissions. This can be checked and changed by navigating to Configure, then Users and making sure you have all admin permissions.

In order to generate your API key in Greenhouse, navigate to Configure and then Dev Center. From here, click on API Credential Management where you can view other Harvest API keys, if any exist, and create your own. To do so, click Create New API Key.

Clicking Create New API Key will open a menu for you to configure and name your key. Under API type, select Harvest. Leave the Partner field blank and give your API Key a description as you see fit. Click Manage Permissions to move onto the next step.

Next you will see a window telling you that your API key has been successfully created, as well as a reminder that if your API key is lost you will have to make a new one. This means it is essential to copy the key and save it to a safe document. Once You're finished, click I have stored the API Key to continue.

(note: the API Key in this screenshot is intentionally blanked out, yours will appear normally)

Once you continue you have the option to select exactly which data Savant will be able to import into your analysis. Notice how you can select or deselect all with the button at the top of the list. Once you are done, click Save.

Once you have your API key copied, you are ready to start connecting Greenhouse to Savant. From Savant's top menu bar, navigate to Data, then Systems and click New System.

Select Greenhouse from the list of possible options and click Next. Enter in the API key generated by Greenhouse and click Authenticate.

You are now ready to access your data from Greenhouse in Savant.

Connecting Data from Greenhouse

On the top left side of your canvas, click the Add Source button, shown below and select your Greenhouse connection. Select your previously authenticated Greenhouse system from the list of available options and click Next.

If you are not currently within an analysis, you can add your connection by navigating to Data and selecting New Dataset then select the previously authenticated connection to your Greenhouse system.

You can now configure the dataset and decide which data from various objects you would like to import into your analysis.

  1. Select which Object you would like to import into your data source from the drop down menu.

  2. Select which Columns you want to include in the dataset.

  3. Once you're done, click Next.

Next, add a name and description to your data set to be used within your canvas and click Confirm.

Your data from Greenhouse is now placed on your canvas as a source for your analysis!

Supported Objects and Fields

Object

Columns

  • id: integer | Primary Key

  • candidate_id: integer

  • applied_at: datetime

  • rejected_at: datetime

  • last_activity_at: datetime | Update Cursor

  • job_post_id: integer

  • status: string

  • custom_fields: json

  • id: integer | Primary Key

  • first_name: string

  • last_name: string

  • company: string

  • title: string

  • updated_at: datetime | Update Cursor

  • application_ids: json

  • custom_fields: json

  • id: integer | Primary Key

  • name: string

  • parent_id: integer

  • id: integer | Primary Key

  • opened_at: datetime

  • closed_at: datetime

  • application_id: integer

  • custom_fields: json

  • id: integer | Primary Key

  • title: string

  • content: string

  • job_id: integer

  • first_published_at: datetime

  • updated_at: datetime | UpdateCursor

  • id: integer | Primary Key

  • name: string

  • status: string

  • updated_at: datetime | UpdateCursor

  • custom_fields: json

  • id: integer | Primary Key

  • application_id: integer

  • job_id: integer

  • candidate_id: integer

  • updated_at: datetime | UpdateCursor

  • status: string

  • custom_fields: json

  • id: integer | Primary Key

  • application_id: integer

  • updated_at: datetime | UpdateCursor

  • status: string

  • start: json

  • end: json

  • id: integer | Primary Key

  • updated_at: datetime | UpdateCursor

  • application_id: integer

  • job_id: integer

  • attributes: json

  • id: integer | Primary Key

  • name: string

  • type_id: number | jsonPath - .type.id

  • type_name: number | jsonPath - .type.name

Publishing Data to Greenhouse

Publishing data to Greenhouse is not currently supported as a destination point within your analysis.

Did this answer your question?