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.
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.
In this article we will cover:
- Configure User Setup Permissions in Greenhouse Recruiting
- Create Harvest API Key for the Greenhouse Recruiting / CodeSignal Integration
- Enter Harvest API Key in CodeSignal
- Create Webhooks for Greenhouse Recruiting / CodeSignal Integration
- Provide CodeSignal Assessment API Key to Greenhouse Recruiting
- Select Default Senders (Optional)
- Add CodeSignal Stage to Job’s Interview Plan
- Send and Review CodeSignal Test From Greenhouse Recruiting
- Schedule CodeSignal Interviews From Greenhouse Recruiting
Configure User Setup Permissions in Greenhouse Recruiting
In order to enable the Greenhouse Recruiting / CodeSignal integration, you will need the following developer permissions:
- Can manage ALL organization’s API Credentials
- 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 noted developer permissions 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 each checkbox. When finished, click Save.
Create Harvest API Key for the Greenhouse Recruiting / CodeSignal Integration
To create a Harvest API key for the integration, click 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.
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.
In the subsequent 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 I have stored the API Key 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.
On the subsequent page, confirm the following permissions are assigned to your new API key:
|
Applications:
|
 |
|
Candidates:
|
 |
If any of the permissions above are not checked, place a check in the box next to the appropriate permission. Click Save when finished.
Your Harvest API key for the Greenhouse Recruiting / CodeSignal. Provide your API key to CodeSignal in the next step.
Enter Harvest API Key in CodeSignal
With your Greenhouse Recruiting Harvest API key copied, navigate to the Integrations page in CodeSignal. 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 likely will be app, app2, app3, or yourcompany.
Create Webhooks for Greenhouse Recruiting / CodeSignal Integration
Note: Before continuing with this section, be sure to download CodeSignal's Chrome Extension.
While still on CodeSignal's Integrations dialog box, click the Webhooks page link underneath the Webhooks section. You will be redirected to Greenhouse Recruiting's Create a New Web Hook page.
From the Create a New Web Hook 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.
Provide CodeSignal Assessment API Key to Greenhouse Recruiting
From CodeSignal's Integration dialog box, navigate to the Assessment API tab. Click Copy next to the Assessment API Key.
Once you have obtained your API key, fill out the form at www.greenhouse.io/asksupport or click here to open a ticket.
Note: Do not send the API key in this initial email.
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.
Note: To verify your identity, the Greenhouse Support Team might request you provide a Support Verification Code before adding the API key to your organization's account.
Select Default Senders (Optional)
Note: This section is an optional step for CodeSignal Certify users only.
In CodeSignal, 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 CodeSignal will specify the assessment is from in the email invitation.
This only applies to candidates who receive an email invitation to take the test directly from CodeSignal or the candidate profile in Greenhouse Recruiting. 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 Recruiting / 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 Test From Greenhouse Recruiting
When candidates are moved into the CodeSignal interview stage, Greenhouse will display a Send Test link.
Note: When you send a test from Greenhouse Recruiting, 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 Recruiting (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 their 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 Recruiting.
Click 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, click View Report to view the candidate's results (including coding replays) in detail on CodeSignal.
Schedule CodeSignal Interviews From Greenhouse Recruiting
Note: Make sure 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, click + CodeSignal Interview Link 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 in the Activity Feed.
