Greenhouse Advanced Interview integration with Codility allows you to seamlessly create interview links directly within Greenhouse and receive detailed insights, including scores, task summaries that provide a score for each task and the used language, interviewer notes and skills evaluations.
When integrated, you can:
- Create multiple Codility interviews links directly from Greenhouse at any stage of your hiring process.
- Select from your interview templates that you can create through the Codility platform tailored for each role that you hire for.
- Provide interviewers and candidates with a single, seamless link to join the session.
- Have interview reports, including task summaries, interviewer notes, skills evaluations and scores, automatically attached to the Greenhouse candidate profile.
- Review collaborative feedback from multiple interviewers in one place to support faster, evidence-based hiring decisions.
Want to find out more about Greenhouse? Request a demo to see whether Greenhouse's software could be of help to your team.
Already a Greenhouse client and want to integrate? Follow the steps below to enable integration. If you don't have access to integrations, please contact sales@codility.com and we'll help you with the next steps.
Setting up the Codility Advanced Screen integration
To enable this integration, you will need to be an Admin user of both your Codility and Greenhouse accounts. Only one user needs to enable the Interview integration and it will be available to the rest of the users on the account.
Step 1. Collect your Harvest API credentials
a. First you need to log into Greenhouse to collect your Harvest API credentials and your Greenhouse User ID.
To access your Harvest API credentials in Greenhouse: Go to Settings > Dev Center > API Credential Management. Click Create New API credentials, and choose the Harvest V3 (OAuth) type.
b. Copy the Client ID and Client Secret, and keep them handy for the next step.
c. Click “I have stored the client credentials."
d. Assign necessary permissions (Manage scopes -> Harvest)
- Applications - List applications
- Attachments - Create attachments
- Candidate
- List candidates
- Update candidates
- Custom Field Options
- Create custom field options
- Destroy custom field options
- List custom field options
- Update custom field options
- Custom Fields
- Create custom fields
- Destroy custom fields
- List custom fields
- Update custom fields
- Users
- List users
Step 2: Collect Greenhouse User ID
a. To access your User ID: Go to Settings > Users > Export to Excel. Find your default User ID in the exported file.
b. Now log into Codility, and navigate to My Account > Settings > Integrations. Find Codility - Advanced Interview and click "Configure."
c. Click "Connect."
d. In the window that appears, paste your Harvest API Credentials and Greenhouse User ID.
e. Copy the Webhook URL, Webhook secret key, and Webhook header identity. Save these somewhere where you can access them momentarily. Click the Submit button.
f. In Greenhouse, go to Settings > Dev Center > Web Hooks and create a new Webhook.
- Name the Webhook; we recommend naming it "Codility Advanced Interview."
- When - choose “Candidate or prospect updated."
- Endpoint URL - paste the Webhook URL that you saved from previous step.
- Secret key - paste the Webhook secret key from the previous step.
- Click Advanced settings and in the Additional HTTP Headers please provide the Codility Webhook header identity from the previous step.
- Click "Create Webhook."
Congratulations! You have successfully integrated Codility Advanced Interview with your Greenhouse account. If you have any problems completing these steps, please contact support@codility.com.
Once you click Submit, three custom fields will be created in Greenhouse on the candidate level:
- Codility Interview Templates
- Create Codility Interview
- Codility Interview Links
Migrating to Harvest API v3
If you already use the Codility Advanced Interview integration with a legacy Harvest API key, you can migrate to Harvest API v3 by updating your credentials in Codility.
To migrate:
- Go to My Account > Settings > Integrations in Codility.
- Find Codility - Advanced Interview and click "Configure."
- Follow step 1a in this documentation to create new Harvest API v3 OAuth credentials in Greenhouse.
- Copy the Client ID and Client Secret.
- Paste the credentials into Codility and save the configuration.
- Note: Your existing Greenhouse User ID can stay unchanged. Your Webhook setup can also stay the same. You do not need to create a new Webhook or update the Webhook URL, secret key, or Webhook header identity.
- After submitting the new credentials, test your Greenhouse workflow to confirm that the integration works as expected.
- For example, create a Codility interview link from Greenhouse and verify that the interview report is attached to the candidate profile after the interview is completed.
- Once you confirm that the Harvest API v3 flow works correctly, you can safely delete the old Harvest API key from Greenhouse.
Additional resources
For additional information not covered here, reach out to support@codility.com.
How to Create a Codility Interview in Greenhouse
Follow these steps to create and manage Codility interviews directly within Greenhouse:
- Open a candidate profile
- Navigate to the candidate you want to schedule an interview for.
- Locate the Codility custom fields
- Scroll to the Additional details section.
- You will see three Codility fields:
- Codility Interview Templates
- Create Codility Interview
- Codility Interview Links
- Select the interview template
- In Codility Interview Templates, choose the predefined template you want to use.
- If you don’t need a template, leave this field blank.
- Create the interview link
- In Create Codility Interview, select either:
- From template – to create an interview based on the selected template.
- Empty – to create an interview without predefined content.
- In Create Codility Interview, select either:
- Refresh the page
- After saving, refresh the candidate’s profile.
- The interview link will appear under Codility Interview Links.
- Share the link
- Copy the interview link and share it with the candidate and interviewers as needed.
- Review results after the interview
- Once the interview ends, interviewers have about one hour to finalize their notes.
- After this period, Codility automatically sends the interview report back to Greenhouse.
- The report which includes the link to the downloadable PDF report is attached to the candidate’s latest application in Greenhouse for easy access.
Create Codility Interview in Greenhouse
Review Interview Report and Summary