CodeSignal

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

In order to enable the Greenhouse Recruiting / CodeSignal integration, you will need the following 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. 

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. 

image-16.png

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.

Job_Setup_tab.png

From the Job Setup page, navigate to Interview Plan on the left-hand panel. Scroll down the page and click + Add a Stage.

image-18.png

 From the Add Stage dialog box, select the CodeSignal stage. When finished, click Add to apply the stage to the job's interview plan.

image-19.png

 

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.

image-20.png

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.

image-21.png

The status of the assessment will be viewable in Greenhouse Recruiting (e.g. Sent).

image-22.png

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.

image-23.png

Click CodeSignal Test within this stage to view a summary of the candidate's scores per task in the test.

image-24.png

When viewing the summary of results, click View Report to view the candidate's results (including coding replays) in detail on CodeSignal.

image-25.png

 

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.

image-26.png

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

finalize_greenhouse_interview_scheduling.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.

image-29.png

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.

image-30.png