CodeSignal aims to make talent accessible by creating software and standards for assessing the technical skills of software developers. Greenhouse Recruiting's integration with CodeSignal allows your organization to add a CodeSignal assessment to a job's interview plan. In this article we will cover:
Note: In addition to the Greenhouse Recruiting permissions covered in this article, the user enabling this integration for their organization will also need to be a CodeSignal Admin.
Configure User Setup Permissions in Greenhouse Recruiting
In order to enable the Greenhouse/CodeSignal integration, you will need the developer permission Can manage ALL organization’s API Credentials and Can manage and configure web hooks.
Contact a Greenhouse user in your organization with Site Admin level permissions with the additional user-specific permission Can edit another user's advanced permissions to apply the API credential management permission to your account. Have the user with Site Admin level permissions edit your user account's permissions by navigating to the Configure icon > Users > Your Name.
The user with Site Admin level permissions should navigate to the Permissions panel on your user page and expand the Developer Permissions dropdown menu.
Select Can manage ALL organization’s API Credentials and Can manage and configure web hooks so that a check is in the checkbox. When finished, click Save.
Create a Harvest API Key for the Greenhouse/CodeSignal Integration
To create a Harvest API key for the integration, click on the Configure icon in the upper right-hand corner. Navigate to Dev Center on the left-hand panel.
From the Dev Center page, click API Credential Management.
From the API Credential Management page, click Create New API Key to generate the API key for CodeSignal.
From the Create new credential dialog box, give your API key a name and select Harvest from the Type dropdown menu. When finished, click Create.
On the Manage API Key Permissions page, give your Harvest API key the following permissions.
- DELETE: Delete Applications
- GET: Retrieve Application
- GET: List Applications
- DELETE: Delete Candidate
- GET: Retrieve Candidate
- GET: List Candidates
- Job Stages
- GET: Retrieve Job Stage
- GET: List Job Stages
- GET: Retrieve Job
- GET: List Jobs
- PATCH: Update Job
- POST: Create a New Job
- GET: List Users
Click Update when finished.
Your Harvest API key for the Greenhouse/CodeSignal integration is created and configured. Navigate to the newly created Harvest API key and click Copy.
Input Greenhouse Recruiting Credentials Into CodeSignal
With your Greenhouse Recruiting Harvest API key copied, navigate to your CodeSignal account. Click your name in the upper right-hand corner and select Integrations from the dropdown menu.
From the ATS Integrations page, click Integrate inline with Greenhouse to open the integration dialog box.
From the integration dialog box, input your organization's subdomain into the appropriate field. The subdomain can be found by looking at the URL when logged into Greenhouse Recruiting.
Note: Your subdomain will either be app, app2, or yourcomany.
Next, input your copied Greenhouse Recruiting Harvest API key in the appropriate field.
Generate Greenhouse Webhooks
Note: Before continuing with this section, be sure to download CodeSignal's Chrome Extension.
While still on CodeSignal's integration dialog box, click the Webhooks page link underneath the Webhooks section. You will be redirected to Greenhouse Recruiting's webhook creation page.
From the Greenhouse Recruiting Webhooks page, the CodeSignal Chrome Extension should automatically populate on the right-hand side of the page. Click Create All.
CodeSignal's Chrome Extension will auto-populate all of the necessary webhooks for the integration. Once all the webhooks are created successfully, click Back to CodeSignal.
You will be redirected back to your CodeSignal account.
Send CodeSignal Assessment API Key to Greenhouse Recruiting
Back on CodeSignal's integration dialog box, click Copy next to the CodeSignal Recruiter Assessment API key.
Note: Do not send the API key in this initial email. API Keys allow access to sensitive data and must be kept secret. If an API Key is shared in an email and your email is intercepted by a malicious third party or your email account is hacked, the hacker would be able to view and access your API Key. For this reason, we require API Keys to be shared securely using SendSafely, Greenhouse’s secure data transfer platform.
The Greenhouse Support Team will respond with a SendSafely link for you to enter your API key. A notification will be sent to the Greenhouse Support Team after you have entered your API key and they will email you to confirm that your API key has been set up in your account and your integration is enabled.
User Account Mapping
From CodeSignal's integration dialog box, click Next to advance the slide to User Account Mapping.
For each CodeSignal user in your organization, select the corresponding Greenhouse user.
Note: All CodeSignal users must be mapped in order to be able to use the Greenhouse Recruiting integration.
Click Save when finished. The integration configuration is now complete.
Add CodeSignal Stage to Job’s Interview Plan
Once the Greenhouse/CodeSignal integration is enabled for your organization, you will be able to add the CodeSignal assessment as an Interview stage.
To do this for an existing job, navigate to a job (All Jobs>Job Name) and click Job Setup from the Job navigation bar.
From the Job Setup page, navigate to Interview Plan on the left-hand panel. Scroll down the page and click + Add a Stage.
From the Add Stage dialog box, select the CodeSignal stage. When finished, click Add to apply the stage to the job's interview plan.
Send and Review CodeSignal's Test From Greenhouse
When candidates are moved into the CodeSignal interview stage, Greenhouse will display a Send Test link.
Note: When you send a test from Greenhouse, the interview instructions are actually sent by CodeSignal.
Select the test that you want to send, as well as the name of the person who should evaluate the test. The candidate's email address will be auto-populated.
The status of the assessment will be viewable in Greenhouse:
Note: Greenhouse Recruiting updates test scores once every hour, so there may be a small delay between a candidate's completion of a test and the recording of his/her score in Greenhouse Recruiting.
Once the test is completed, the candidate's score will be recorded in the CodeSignal Test stage.
Schedule CodeSignal Interviews From Greenhouse
You can schedule CodeSignal interview sessions directly within Greenhouse Recruiting by clicking + Add Interview in the appropriate stage..
Under the Location field is a + CodeSignal Interview Link button. Click to auto-generate an interview URL.
The CodeSignal Interview URL will auto-populate within the Location field. Send this URL to both the interviewer(s) and candidate to access their interview session at the scheduled time.
During or after the interview session, the interviewer can leave optional candidate feedback within CodeSignal. If provided, this feedback will appear as a note within Greenhouse Recruiting on the candidate's profile under Activity Feed.