Foley Carrier Services is a trusted partner when it comes to compliance, security, and anything that falls under the drug and background screening umbrellas. Foley Carrier Services 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 Foley Carrier Services 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 Foley Carrier Services 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 Foley Carrier Services Integration

To configure the Greenhouse Recruiting / Foley Carrier Services 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 Foley Carrier Services integration.


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

  • API type: Harvest
  • Partner: Foley Carrier Services
  • Description: Foley Carrier Services Harvest API key


Verify that the following permissions are selected for the Foley Carrier Services integration:

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

Create a webhook

Before enabling the Greenhouse Recruiting / Foley Carrier Services integration, Greenhouse Recruiting requires two pieces of information:

  • Foley Carrier Services's Endpoint URL
  • Foley Carrier Services's Secret Key

Contact your Foley Carrier Services 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 Foley Carrier Services 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 Foley Carrier Services team
  • Secret Key: The Secret Key received from the Foley Carrier Services team

Use Greenhouse Recruiting / Foley Carrier Services 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, Foley Carrier Services is auto-notified to generate an invitation link, which is sent to the candidate so they can provide their information for Foley Carrier Services 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.