Good Egg is a trusted partner when it comes to compliance, security, and anything that falls under the drug and background screening umbrellas. Good Egg looks at a candidate's past, present, and future behaviors to paint a more complete picture of a potential candidate and mitigate the risk associated with hiring them.

Greenhouse Recruiting's integration with Good Egg allows you to invite candidates to complete the background screen directly from the candidate's profile page, and receive the screening results in Greenhouse Recruiting once completed, with updates along the way. With Good Egg and Greenhouse Recruiting working together, your candidates and hiring team will experience a faster, more efficient screening process while saving time on manual processes and dual entry.

Create Harvest API key for the Good Egg Integration

To configure the Greenhouse Recruiting / Good Egg integration, you'll need to create a Harvest API key.

Follow the steps in this article to create the key, and verify that the credentials and permissions below are selected when configuring the Good Egg integration.


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

  • API type: Harvest
  • Partner: Good Egg
  • Description: Good Egg Harvest API key


Verify that the following permissions are selected for the Good Egg integration:

  • Activity Feed:
    • GET: Retrieve Activity Feed
  • Candidates:
    • POST: Add Note

Create a webhook

Before enabling the Greenhouse Recruiting / Good Egg integration, Greenhouse Recruiting requires two pieces of information:

  • Good Egg's Endpoint URL
  • Good Egg's Secret Key

Contact your Good Egg representative to obtain your Endpoint URL and Secret Key. Once you have these two pieces of information, follow the steps in this article to create your webhook. Use the values listed below to configure the webhooks.

  • Name: We suggest Good Egg BGC
  • When: Be sure to select the right web hook so the web hook fires at the appropriate event in Greenhouse Recruiting [Candidate has been hired]
  • Endpoint URL: The Endpoint URL received from the Good Egg team
  • Secret Key: The Secret Key received from the Good Egg team

Use Greenhouse Recruiting / Good Egg Integration

To initiate a background check, navigate to the desired candidate. The candidate must be in the Offer stage to initiate the screen. Once the candidate is in the Offer stage, Good Egg is auto-notified to generate an invitation link, which is sent to the candidate so they can provide their information for Good Egg to begin the background check. Once the background check is kicked off, depending on your settings, you will be notified of specific actions related to the report in Greenhouse Recruiting under the candidate's Details tab.

Once results are in, a link will be sent to your Greenhouse Recruiting Dashboard, where you will be able to access the full report.

Additional support

Contact for troubleshooting assistance regarding the integration.