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: The person enabling this integration for their organization will need to be a CodeSignal admin.

Set up the CodeSignal integration

Create a Harvest API key

To configure the Greenhouse Recruiting / CodeSignal integration, you'll need to create a Harvest API key.

Follow the steps in this article to create the key, and verify that the credentials and permissions below are selected when configuring the CodeSignal integration.


In the Create New Credential box, make the following selections:

  • API type: Harvest
  • Partner: CodeSignal (optional)
  • Description: CodeSignal Harvest API key


Verify that the following permissions are selected for the CodeSignal integration:


  • GET: Retrieve application


  • GET: Retrieve candidate
  • GET: List candidates
  • POST: Add note


  • Get: List users

When finished, click Save.

Your Harvest API key for the Greenhouse Recruiting / CodeSignal. Provide your API key to CodeSignal in the next step.

Enter the 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.

CodeSignal integration image

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

CodeSignal integration image

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, etc., or yourcompany.

CodeSignal integration image

Add the CodeSignal assessment API key to Greenhouse Recruiting

From CodeSignal's Integration box, click the Assessment API tab.

Click Copy next to the Assessment API Key.

CodeSignal integration image

Once you've obtained your API key, fill out the form at or click here to open a ticket. Indicate whether you'd 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: Don't send the API key in this initial email. Greenhouse Technical Support will respond with a SendSafely link for you to enter your API key.

Greenhouse Technical Support will email you once your API key has been set up in your account and your integration has been enabled.

Note: To verify your identity, Greenhouse Technical Support 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 won't be listed in the email invitation.

CodeSignal integration image

Click Save. The Greenhouse Recruiting / CodeSignal integration configuration is now complete.

Use the CodeSignal integration

Add CodeSignal stage to your job's interview plan

Once the Greenhouse Recruiting / CodeSignal integration is enabled for your organization, you'll be able to add the CodeSignal pre-screen (formerly CodeSignal test) as an interview stage.

To do this for an existing job, navigate to a job (Jobs > Job Name) and click Job Setup from the job navigation bar.

From the Job Setup page, click Interview Plan on the left. Scroll down the page and click + Add a Stage.

From the Add Stage box, select the CodeSignal stage: CodeSignal Pre-screen.

When finished, click Add to apply the stage to the job's interview plan.

Send and review CodeSignal Pre-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 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 will be viewable in Greenhouse Recruiting (like 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 is completed, the candidate's score will be recorded in the relevant CodeSignal Pre-screen stage, and the grader will be notified via email to review the candidate's result and complete a scorecard in Greenhouse Recruiting.

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 on the candidate's profile in Greenhouse Recruiting.

Click CodeSignal Pre-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.

CodeSignal integration image

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 interviewers and candidates to access their interview session at the scheduled time.

Finalize the invitation and send this URL to both the interviewers and the candidates 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 or troubleshooting not covered here, reach out to