Private Eyes is one of only a few companies in the industry that has developed their own easy-to-use background screening platform, resulting in faster results for background screening, verifications, and drug testing.

Greenhouse Recruiting's integration with Private Eyes makes it simple to manage the entire screening process in one system.

You can easily onboard candidates, submit background check orders, send candidate screening invites, track their progress, view reports, and even initiate adverse action letters. Spend less time initiating and waiting for your background checks with Private Eyes – the platform provider that clients trust.

Configure custom options in Greenhouse Recruiting for the Private Eyes integration

Note: To configure custom options in Greenhouse Recruiting, you will need to be a Site Admin or a Job Admin with the additional user-specific permission 'Can manage custom fields'.

To configure the Greenhouse Recruiting / Private Eyes integration, you will need to add a custom offer field in Greenhouse Recruiting.

To add a custom offer field, click Configure Configure-icon.png and select Custom Options on the left.


Click Offers under the Company Custom Fields section.


From the Manage Offer Fields page, click Add Field.


Make the following selections on your new custom candidate field:

  • Field Name: PackageCode
  • Description: Package Code
  • Field Type: Single select
  • Check “Required” as true


Note: Be sure to add background check packages to the Options field with each package separated by a line break (see screenshot above).

When finished, click Save.

Create a Harvest API key for the Greenhouse Recruiting / Private Eyes integration

To configure the Greenhouse Recruiting / Private Eyes integration, you’ll need to create a Harvest API key.

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


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

  • API Type: Harvest
  • Partner: Private Eyes (or Unlisted Vendor)
  • Description: Private Eyes Harvest API Key


Verify that the following permissions are selected for the Private Eyes integration:


  • GET: Retrieve candidate
  • GET: List candidates
  • POST: Add note


  • GET: Retrieve user
  • GET: List users

Activity Feed

  • GET: Retrieve activity feed

Custom Field Options

  • GET: Custom field options
  • POST: Create custom field options
  • PATCH: Update custom field options

When finished, click Save.

Your Harvest API key for the Greenhouse Recruiting / Private Eyes integration is created and configured. Provide your Harvest API key to your Private Eyes onboarding team so they can finish setting up the integration.

Create a webhook

To integrate Private Eyes with Greenhouse Recruiting, you'll also need to create a webhook. 

First, contact Private Eyes support at to request your Endpoint URL and Secret Key. In the subject line of your email, enter: Greenhouse Endpoint URL & Secret Key Request: [your company name].

Once you receive the Private Eyes Endpoint URL and Secret Key, you can create a new web hook by following the steps in this article. Use the values listed below to configure the webhook.

  • Name: Private Eyes Integration
  • When: Candidate has been hired
  • Endpoint URL: The Endpoint URL provided by Private Eyes 
  • Secret Key: Enter the Secret Key provided by Private Eyes

Your Greenhouse Recruiting and Private Eyes integration is now configured and complete.

Use the Greenhouse Recruiting / Private Eyes integration

Submit a background check order

To place a Private Eyes order, navigate to a candidate's profile and click Details. Confirm the following information is complete:

  • Candidate's First Name
  • Candidate Last Name
  • Candidate Email Address

Note: For the order to process successfully, you must have a valid account in the Private Eyes platform, and your email address in Greenhouse Recruiting and Private Eyes must match.

Next, click the On Job tab and navigate to Offer Details on the left-hand side.

Click Mark Candidate as Hired.


In the Accept Offer window, fill in the necessary fields and select the Package Code.


Click Save. The order will then be created in Private Eyes.

Track status of background check order

You can track the status of the background check in the Activity Feed of the candidate's profile in Greenhouse Recruiting.

To view a background check's details, click the link in the Activity Feed note from Private Eyes.


View final background check report

Once a background check report is completed, Private Eyes will send an email notification to the user who marked the candidate as hired.

Private Eyes also posts a status update in the candidate's Activity Feed. To see the final background check, click the link in the Activity Feed.


Additional resources

For assistance using this integration, reach out to Private Eyes Support at