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 how to:
- Configure User Setup Permissions in Greenhouse Recruiting
- Create a Harvest API Key for the Greenhouse/CodeSignal Integration
- Input Greenhouse Recruiting Credentials Into CodeSignal
- Create Greenhouse Webhooks
- Send CodeSignal Assessment API Key to Greenhouse Recruiting
- Select Default Senders (Optional; CodeSignal Certify Users Only)
- Add CodeSignal Stage to Job’s Interview Plan
- Send and Review CodeSignal Tests from Greenhouse Recruiting
- Schedule CodeSignal Interviews From Greenhouse Recruiting
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.
- Applications
- DELETE: Delete Applications
- GET: Retrieve Application
- GET: List Applications
- Candidates
- DELETE: Delete Candidate
- GET: Retrieve Candidate
- GET: List Candidates
- Job Stages
- GET: Retrieve Job Stage
- GET: List Job Stages
- Jobs
- GET: Retrieve Job
- GET: List Jobs
- PATCH: Update Job
- POST: Create a New Job
- Users
- 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 the Integrations page on inCodeSignal. Click your name in the upper right-hand corner and select Integrations from the dropdown menu.
Paste your API key into the Harvest API Key field and click Save.
Fill in the appropriate Greenhouse subdomain for your account and click Save.
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.
Create 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, navigate to the Assessment API tab. Click Copy next to the Assessment API Key.
Once you have your CodeSignal assessment API key, navigate to www.greenhouse.io/asksupport or click here to open a ticket.
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.
Select Default Senders (Optional; CodeSignal Certify Users Only)
For CodeSignal Certify users only: Under Certify Default Senders, specify a team member as the default sender for each of your certified assessments. This is the individual on whose behalf we will specify the assessment is from in the email invitation.
Notes:
- This only applies to candidates who receive an email invitation to take the test directly from CodeSignal or the candidate profile in Greenhouse.
- The individual’s email address will NOT be listed in the email invitation.
Click Save. The Greenhouse Recruiting/CodeSignal 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 certification assessment or 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 (e.g. “Sent”):
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, and the grader will be notified via email to review the candidate's result and complete a scorecard in Greenhouse.
Once the grader has completed his or her scorecard, their overall recommendation for the candidate will also be displayed along with the candidate's score in the CodeSignal Test stage on the candidate's profile in Greenhouse.
Clicking on "CodeSignal Test" within this stage to view a summary of the candidate's scores per task in the test.
When viewing the summary of results, you may click on "View Report" to view the candidate's results (including coding replays) in detail on CodeSignal.
Schedule CodeSignal Interviews From Greenhouse
Note: Make sure that you have already downloaded CodeSignal's Chrome Extension.
You can schedule CodeSignal interview sessions directly within Greenhouse Recruiting by clicking + Schedule Interview in the appropriate stage.
Fill out the date and time, and then select an interviewer and a location. Click the "Schedule and Continue" button.
Under the Description field is a "+ CodeSignal Interview Link" button. Click to auto-generate an interview URL, which will populate at the top of the description field.
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.
Finalize the invitation and send this URL to both the interviewer(s) and the 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.
