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 Pre-Screen assessment or Tech Screen 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:

Configure user setup permissions in Greenhouse Recruiting

In order to enable the Greenhouse Recruiting / CodeSignal integration, you will need the developer permissions Can manage ALL organization’s API Credentials.

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 Configure.png > Users > Your Name.

Configure_-_Users.png

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 so that a check is in each checkbox. When finished, click Save.

ALL_API___Web_hooks.png

Create Harvest API key for the Greenhouse Recruiting / CodeSignal integration

To create a Harvest API key for the integration, click the Configure icon Configure.png in the upper right-hand corner. Navigate to Dev Center on the left-hand panel. From the Dev Center page, click API Credential Management.

1._Dev_Center_-_API_Credential_Management.png

From the API Credential Management page, click Create New API Key to generate the API key for CodeSignal.

2._Create_new_API_key.png

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.

mceclip0.png

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.

3._API_key_created.png

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

Applications:

  • GET: Retrieve Application
mceclip1.png

Candidates:

  • GET: Retrieve Candidate
  • GET: List Candidates
  • POST: Add Note

mceclip0.png

Users:

  • Get: List Users

Screen_Shot_2021-05-25_at_6.30.59_PM.png

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.

image-8.png

Paste your API key into the Harvest API Key field and click Save.

image-9.png

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.

image-10.png

Note: Your subdomain likely will be app, app2, app3, or yourcompany.

image-11.png

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.

image-15.png

Once you have obtained your API key, fill out the form at www.greenhouse.io/asksupport or click here to open a ticket. Please indicate whether you would like the CodeSignal Pre-Screen stage, CodeSignal Tech Screen stage, or both stages added to your account, in which case you’ll provide two API keys.

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 Pre-Screen (formerly CodeSignal Test) or CodeSignal Tech Screen 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: CodeSignal Pre-Screen or CodeSignal Tech Screen. When finished, click Add to apply the stage to the job's interview plan.

Send and review CodeSignal Pre-Screen or CodeSignal Tech Screen 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 Pre-Screen assessment or Tech Screen 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 Pre-Screen assessment or Tech Screen 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 Pre-Screen assessment or CodeSignal Tech Screen is completed, the candidate's score will be recorded in the relevant CodeSignal Pre-Screen or CodeSignal Tech Screen 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 Pre-Screen or CodeSignal Tech Screen stage on the candidate's profile in Greenhouse Recruiting.

Click CodeSignal Pre-Screen or CodeSignal Tech Screen within this stage to view a summary of the candidate's scores per task in the test.

Note: The CodeSignal Pre-Screen stage may appear as CodeSignal Test on jobs or reports created before April 2022.

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.

Greenhouse_interview_date_interviewer_and_location.png

Under the Description field, click + CodeSignal Interview Link to auto-generate an interview URL, which will populate at the top of the Description field.

Schedule_Greenhouse_Interview.png

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.

Additional resources

For additional information not covered here, reach out to support@codesignal.com.