CodeSignal’s integration with Greenhouse Recruiting allows users to send assessments to test-takers 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.
Prerequisites
- You must be logged in to your CodeSignal account.
- You must have a CodeSignal user type of Admin.
- You must be logged in to your Greenhouse account.
- You must have developer permissions on Greenhouse (specifically, "Can manage ALL organization's API Credentials")
Skip to a step
Configure Harvest API
1. Begin by logging in to both your Greenhouse and CodeSignal accounts. Navigate to Config tab at the top of your CodeSignal account and click Integrations.
2. Fill in the appropriate Greenhouse subdomain for your account. Your subdomain will be app, app2, or [yourcompany].
3. Under Client configuration, click Connect to Greenhouse. When prompted, click Authorize to allow CodeSignal to access your Greenhouse account.
4. Once connected, you will be redirected back to CodeSignal and see confirmation of the connection.
5. [Optional] Create custom fields for your assessments.
6. 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.
Configure Assessment API
7. Follow the steps in this article to retrieve your API key from CodeSignal and add the assessment stage in your interview plans. In CodeSignal, this key can be found within the ASSESSMENT API tab.
Once you’ve set up your interview plans and configured your take home test, you’ll be able to send the test to candidates.
8. Click Save. Set up in CodeSignal is now complete!
Configure CodeSignal Assessments
9. In Greenhouse, you will now be able to add the CodeSignal Assessments 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 Assessments. Click "Add" to incorporate sending a CodeSignal Assessments to your interview plan.
Congratulations! You have successfully integrated your Greenhouse account and your CodeSignal account.
Next step: Send CodeSignal 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.
- Greenhouse allows a single result only per job application.
- Evaluation results cannot be updated after they are populated.
- There is no way to resend an invitation from Greenhouse.
- There is no way to cancel an invitation from Greenhouse.
- There is no way to merge two Greenhouse candidate profiles together.
- There is no way to track public links within Greenhouse.
- There is no synchronization with Greenhouse if you send an invitation from CodeSignal directly (inviting through CodeSignal does not automatically show up in Greenhouse).
- There is no way to configure evaluation invitations from Greenhouse — they all have to be done through CodeSignal (i.e. changing invitation completion deadlines).