How do I integrate Greenhouse with GoCo?

Step-by-step instructions on how to set up GoCo's integration with Greenhouse.

GoCo is a flexible, all-in-one HR solution that makes it easy to automate and streamline all your HR, from hiring and onboarding to benefits, payroll, and more. Our mission at GoCo is to help businesses spend less time on manual, painful, and complex HR tasks to focus on growing happier, more productive teams.


Utilizing a recipe in Workato, an iPaaS, Greenhouse Recruiting’s integration with GoCo syncs candidates & candidate data from Greenhouse to GoCo when the hired stage is reached. Keep reading to learn how to set up this integration. 

Setting Up your Integration 

In GoCo, navigate to your Marketplace either from the main navigation tabs on the left side of your screen or from your company home page.

Screen Shot 2022-06-23 at 3.40.46 PM

Find Greenhouse by clicking on the “Applicant Tracking” tab under Categories.

Screen Shot 2022-06-23 at 3.42.34 PM

Once you locate Greenhouse, click the blue "+Add" button

Screen Shot 2022-06-23 at 3.41.20 PM

This will take you to view all of the premade recipes available for this integration & to "Build Your Own". Check out our help article on how to "Build Your Own" recipe here!

Before you are ready to "Build Your Own" recipes, however, you will need to activate this integration.

Begin by hitting the "Use This Recipe" button next to the recipe titled "Sync Candidate to GoCo when candidate stage is changed to "Hired" in Greenhouse.”

Screen Shot 2022-06-24 at 1.51.23 PM

This will open a new screen to edit this recipe, here click the "Use This Recipe" button again. Screen Shot 2022-06-24 at 1.55.27 PM

 

GoCo will buffer for a minute before letting you know that your recipe is ready for testing. Now we will hit "Test recipe" & resolve any red highlighted items.

Screen Shot 2022-06-24 at 2.41.09 PM-1

You will be taken back to this screen & will now need to complete the following two steps to get connected. 

Screen Shot 2022-06-24 at 4.27.34 PM

  1. Validate connection to Greenhouse by entering the Harvest API key
  2. Create a Webhook for the Greenhouse Recruiting/GoCo Integration 

Please Note: To configure the Greenhouse Recruiting / GoCo integration, you’ll need the developer permissions Can manage and configure web hooks and Can manage ALL organization’s API Credentials in Greenhouse.

To assign this permission, find a Greenhouse Recruiting user in your organization with Site Admin permission and the user-specific permission Can edit another user's advanced permissions to update your account.

The Site Admin can update your permissions by navigating to your user page. Select Configure icon > Users > Your Name.

The Site Admin should scroll to the User-Specific Permissions panel on your user page and expand the Developer Permissions dropdown menu. 

Select Can manage and configure web hooks & Can manage ALL organization’s API credentials in the Developer Permissions section and click Save.

Repeat as necessary for any other user that needs to set up the integration.

 

Step 1: Create a Harvest API Key for the Greenhouse Recruiting/GoCo Integration

In Greenhouse, click on the Configure icon and select Dev Center on the left.

Screen Shot 2022-06-24 at 4.36.37 PM

Select API Credential Management in the Dev Center.

Screen Shot 2022-06-24 at 4.39.05 PM

From the API Credential Management page, click Create New API Key to generate the API key for GoCo.

Screen Shot 2022-06-24 at 4.43.15 PM

In the Create New Credential box, make the following selections:

  • API Type: Harvest
  • Partner: Optional
  • Description: GoCo Harvest API Key

Click Manage Permissions

Screen Shot 2022-06-24 at 4.45.16 PM

Click Copy to save your API key to your clipboard. Store the API key in a secure location to provide to GoCo in the next step.

Screen Shot 2022-06-24 at 4.51.41 PM

Click I have stored the API Key once you have copied and saved the key.

Screen Shot 2022-06-24 at 4.53.11 PM

Note: You won’t be able to view the API key after clicking I have stored the API Key. If you lose your API key or need to access it later, you’ll need to generate a new key and provide it to GoCo.

Select the checkbox next to “Select All”. 

When you’re finished, click Save

Your Harvest API key for the Greenhouse Recruiting / GoCo integration is created and configured. You may now enter it in GoCo’s Integration Builder.

Screen Shot 2022-06-24 at 5.03.20 PM

Step 2: Create a Webhook for the Greenhouse Recruiting / GoCo Integration

To create the Webhook, return to Greenhouse &  click the Configure icon in the upper right corner then select Dev Center on the left.

Screen Shot 2022-06-24 at 4.36.37 PM

Click Web Hooks on the Dev Center. Click Web Hooks again on the next page.

Screen Shot 2022-06-27 at 10.37.29 AM

Enter the following information on the next page to configure a new webhook:

  • Name: A descriptive name for your integration. Most customers choose GoCo Integration
  • When: The time that the event will be sent to GoCo. Select the following options for this integration:
    • CANDIDATE HAS BEEN HIRED

Endpoint URL: This is acquired from step 1, the trigger in the recipe.

Screen Shot 2022-06-27 at 10.38.34 AM
  • Secret Key: You can use 123

    Note: Before you can create the webhook, the recipe must be started.

Screen Shot 2022-06-27 at 10.43.38 AM

 

When you’re finished, click Create Web Hook.

Screen Shot 2022-06-27 at 10.49.24 AM

Note: Ensure that “Disabled?” is set to No or the webhook will not work.

Your Greenhouse Recruiting account and GoCo account can now communicate with each other in-real-time through webhooks. You may now enter it in GoCo’s Integration Builder.

Now, simply move a candidate in Greenhouse to “Hired.” 

Almost instantly, the employee will appear in GoCo showing that they were imported from Greenhouse! 

Screen Shot 2022-06-27 at 10.53.42 AM

For any additional questions, please reach out to us at help@goco.io or your Client Success Manager.

Happy Hiring! 🥥 💚