Greenhouse Integration Set-Up

You can use CodeSignal and Greenhouse together to both send candidates Pre-Screen coding assessments, as well as receive the scores in Greenhouse. To implement this integration, you need to authorize CodeSignal to use your Greenhouse account. 

The Greenhouse integration with CodeSignal only needs to be completed by ONE user from your company. 

1. Begin by logging in to your CodeSignal account. Navigate to Integrations from your account dropdown in the upper right corner of your dashboard. Or, you can access this page directly from this Greenhouse ATS Integrations page link. 

2. Be sure you are on the Greenhouse page of CodeSignal's ATS Integrations. In the next step, you will enter a key from Greenhouse into the Harvest API Key field. 

3. Open Greenhouse in a new window or tab. From your dashboard, click the Configure (gear) icon in the upper right-hand corner. Then, navigate to Dev Center on the left-hand panel. From the Dev Center page, click API Credential Management.

4. From the API Credentials page, click the Create New API Key button to generate the API key you'll use in CodeSignal.

5. In the Create New Credential dialog box, make the following selections:

• API Type: Harvest
• Partner: CodeSignal
• Description: CodeSignal Harvest API Key

When finished, click Manage Permissions to generate the Harvest API key and automatically assign it the appropriate permissions required by CodeSignal.

6. In the next dialog box, click Copy to save your API key to your clipboard. Store the API key in a secure location to provide to CodeSignal in the next step. Click the I have stored the API Key button once you have copied and saved the key.

Note: You cannot access the full API key again after clicking I have stored the API Key. If you lose your API key and need to access it later, you must create a new API key, provide it to the integration partner, and then revoke access to the original key.

7. On the subsequent page, confirm the following permissions are assigned to your new API key:

8. Go back to the CodeSignal tab and paste your new API key into the Harvest API Key field of the Greenhouse Harvest modal. Click the SAVE button.

9. Fill in the appropriate Greenhouse subdomain for your account. Your subdomain will be app, app2, or [yourcompany].

10. Navigate to the ASSESSMENT API tab and click COPY to copy the pre-populated CodeSignal Assessment API Key to your clipboard. 

Note: You need to give this key to your Greenhouse account manager. Start by emailing Greenhouse Support. To contact Greenhouse support, submit a request using the “Get help” option from the Greenhouse dashboard to open a ticket and let them know if you would like to add the Pre-Screen stage to your interview plan.

The Greenhouse support team will send you a SendSafely link so that you can send the API key in an encrypted format.

Once the Greenhouse support team has uploaded this key to your Greenhouse account, CodeSignal Pre-Screen will be among the available options when you're creating an interview plan in Greenhouse. 

11. Default Greenhouse User: In this field, you may specify the Greenhouse user account that will be used to submit feedback or add notes when a more accurate matching user cannot be found. For convenience, you can create a new Greenhouse user account for this purpose.

12. Click Save. Set up in CodeSignal is now complete!

Configure CodeSignal Pre-Screen13. In Greenhouse, you will now be able to add the CodeSignal Pre-Screen stage to the interview plans of your choice. Select a job and click on "Job Setup." Scroll down to Interview Plan and click "Edit."

Click "Add Stage" and select CodeSignal Pre-Screen. Click "Add" to incorporate sending a CodeSignal Pre-Screen to your interview plan.

Congratulations! You have successfully integrated your Greenhouse account and your CodeSignal account.

Next step: Send CodeSignal Pre-Screen Assessments from Greenhouse

A note on known limitations:

Please be aware of a few functions that are not currently possible due to limitations with the platforms. We will continue to develop the CodeSignal/Greenhouse integration, and hope to provide this functionality as new product enhancements are released by Greenhouse. 

1. Greenhouse allows a single result only per job application.

2. Evaluation results cannot be updated after they are populated.

3. There is no way to resend an invitation from Greenhouse.

4. There is no way to cancel an invitation from Greenhouse.

5. There is no way to merge two Greenhouse candidate profiles together.

6. There is no way to track public links within Greenhouse.

7. There is no synchronization with Greenhouse if you send an invitation from CodeSignal directly (inviting through CodeSignal does not automatically show up in Greenhouse).

8. There is no way to configure evaluation invitations from Greenhouse — they all have to be done through CodeSignal (i.e. changing invitation completion deadlines).

Questions? Email support@codesignal.com