Greenhouse + Certn Integration Setup

Overview

The Greenhouse + Certn integration allows hiring teams to initiate, track, and complete background checks directly within Greenhouse.

Instead of switching between systems or manually triggering checks, recruiters can move a candidate to a configured stage in Greenhouse and Certn automatically initiates the background check. Status updates and report access sync back into Greenhouse, giving your team real-time visibility without disrupting workflow.

With this integration, you can:

• Automatically trigger background checks based on stage
• Clients can choose whether orders are attributed to the user who triggered the order via Greenhouse provided they have an account in CertnCentric
• View live status updates inside Greenhouse
• Access reports via PDF or secure Certn portal
• Assign checks to a default group within Certn for centralized management
• Support compliant, post-offer, candidate-initiated screening workflows

The result is faster hiring, stronger compliance alignment, and fewer manual steps for your team.

Setup

Step 1: Contact Greenhouse Support

To initiate the process of setting up your integration, open a support ticket with Greenhouse:

1. Visit support.greenhouse.io/hc/en-us. 
2. Interact with the chat until you have an option to "Contact Support". 
3. Complete the form with the following details:

⚠️ Important: Please indicate where your organization is located: North America, EMEA, or Australia by indicating one of these regions as outlined in the template. Do not send any sensitive information (e.g., API keys) in this initial form. Use the SendSafely link to submit your API key securely. 

Step 2: Generate Your API Key in Certn

While waiting for Greenhouse to respond, you can proceed with the following:

1. Log in to Certn.
2. Navigate to Settings → Integrations.
3. Select Add next to the Greenhouse integration.
4. Copy the generated API Key and store it securely (Step 1 in the screenshot below). 

⚠️ Important: You will not be able to access this API key again after leaving the page. Make sure it is saved somewhere secure before proceeding.

Step 3: Configure Integration Settings in Certn

Before activating the integration, configure your default preferences.

1. Choose how you’d like to receive the report in Greenhouse by selecting your Report URL Type (Step 2 in the screenshot above):
   1. A PDF report that does not require a user to log in, or;
   2. A secure Certn portal link that requires user authentication to view the report.
2. Require Authorised Certn User (Step 3 in the screenshot above)
   1. When enabled: Only Greenhouse users with a matching Certn account (based on their email address) in the default group can initiate orders. Orders are attributed to the corresponding Certn user.
   2. When disabled: Greenhouse users can initiate orders without a matching Certn account. If no matching account exists, orders are attributed to the Certn user who configured the integration.
3. Select a default Certn Group to use when ordering via Greenhouse (Step 4 in the screenshot above). Greenhouse will assign a background check to the chosen group, using the billing profile and preferences set up in that group. This will be the default group where you can view all background checks from Greenhouse in Certn.
4. Select Create Integration to save the integration settings in Certn. ⚠️ Important - this step is required to activate the Certn API key, which is necessary to establish the connection with Greenhouse.

Once configured, you’re ready to finish the connection setup with Greenhouse.

Step 4: Secure API Key Submission

The Greenhouse Support Team should respond to your request from Step 1 with a SendSafely link where you can enter your API key generated in Step 2. 

• Note: The Greenhouse Support Team may request a Support Verification Code to verify your identity before adding the API key to your organization's account.

Once this is done, the Greenhouse Support Team will enable your integration, and you will receive a confirmation email from them.

Integration Complete 

Your Certn + Greenhouse integration is now active.

Recruiters can initiate background checks from within Greenhouse, and status updates and reports will sync back automatically.

If you need to adjust report types or default groups in the future, you can do so directly within Certn.