Codeaid assessment tests provide hiring teams with a better understanding of how well a candidate is likely to perform in a given role. By integrating assessments directly into the candidate journey through Greenhouse, you can streamline and reduce the effort involved in the hiring process. Initiate assessments within Greenhouse, and conveniently receive scores and view detailed assessment reports directly on the candidate’s profile.
Codeaid integration with Greenhouse Recruiting allows you to seamlessly add Codeaid assessment to a job's interview plan.
Enable the integration
There are two steps to this process:
- Generate an API key from Codeaid and provide it to Greenhouse(mandatory step)
- Enable the Harvest API in Codeaid. This allows you to access Codeaid specific information in Greenhouse.(optional)
Follow the steps in this article to retrieve your API key from your Codeaid representative and add the assessment stage in your interview plans.
Retrieve API key from Codeaid:
Log in to your Codeaid account as an Owner/Admin.
From the sidebar, open the Settings page.
Click on the Integrations tab.
Locate the Greenhouse integration card and click the three dots.
Click Integrate. Codeaid will prompt you to confirm your password for security reasons.
Enter your account password and click Confirm.
A confirmation pop-up will appear, stating that you are integrating your Codeaid organization with Greenhouse.
Click Yes to continue. You will then be provided with a newly created API key.
Copy the API key by clicking the copy icon or manually selecting the highlighted key.
If you accidentally close the pop-up, don’t worry—you can reopen it by clicking Integrate again.
Integrate Codeaid with Your Greenhouse Account
Once you have copied your API key, click here to open a ticket with Greenhouse Support.
Note: Don't send your API key in the initial ticket. Greenhouse Support will respond with a SendSafely link for you to securely share the API key.
Wait for a confirmation email from Greenhouse Support. You may be required to verify your account before you can proceed.
If they need your API key, Greenhouse Support will provide a SendSafely link where you can enter your API key. Once Greenhouse Support has been notified that you've entered your API key, they will send a confirmation email.
Enable Harvest API (optional)
Codeaid Harvest integration with Greenhouse Recruiting allows the user to focus more on inviting candidates by providing essential details on Greenhouse by utilizing Harvest API
For Codeaid Harvest integration to work, Codeaid needs an API key and a User ID, follow the following steps to create the API key and retrieve the User ID
Create a Harvest API key
To configure the integration, you’ll need to create a Harvest API key.
Follow the steps in this article to create the key, and verify that the permissions below are selected when configuring the Codeaid integration.
Credentials
In the Create New Credential box, make the following selections:
- API Type: Harvest
- Partner: Codeaid or Unlisted Vendor
- Description: Codeaid Harvest API Key
Permissions
Verify that the following permissions are selected for the Codeaid integration:
-
Harvest V1
-
Activity Feed
- Get: Retrieve Activity Feed
-
Applications
- Get: Retrieve Application
-
Candidates
- Patch: Edit Candidate
- Post: Add Note
-
Custom Fields
- Get: Get custom fields
- Post: Create custom field
-
Users
- Get: Retrieve User
-
Activity Feed
Retrieve user ID
Codeaid will need a Greenhouse Recruiting user ID to associate with updates and changes created by the integration.
Click the Configure icon on your navigation bar and then click Users on the left.
Click Export to Excel.
A spreadsheet will be downloaded to your computer. Open the Excel file and locate the user ID in the User ID column.
Enable Harvest API on Codeaid
From the sidebar, open the Settings page.
Click on the Integrations tab.
Locate the Greenhouse integration card and click the three dots then click Settings.
A popup will appear. Select Enable Harvest API checkbox. The textboxes to enter Harvest User ID and API key will be displayed
Paste the User ID and API key collected from previous steps and click Save.
Wait for at least 2 minutes for the settings to be applied.
To make sure the harvest integration is enabled successfully, open any candidate details on greenhouse then Click on ‘Candidate’ tab of the candidate in Greenhouse and you should see new custom fields created by Codeaid, under 'Additional details'
Once you’ve set up your interview plans and configured your take home test, you’ll be able to send the test to candidates.
Use the integration with Greenhouse Recruiting
Once the Codeaid integration is enabled for your organization, you will be able to add the Codeaid assessment as an interview stage.
You can send an assessment to a candidate by selecting the Send Test button next to the interview stage. The assessment instructions will be sent by Codeaid.
After it has been sent, the assessment’s status will appear in Greenhouse Recruiting.
And if you have enabled Harvest integration, Codeaid custom fields will be populated with candidate details from Codeaid.
Once the candidate has submitted their test, the Interview Kit will contain a link to view the submitted test in the Codeaid application.
To see a candidate’s results in Codeaid, click View Report .
This will open the candidate URL in Codeaid.
Click ‘View Report’ to see the grading criteria of Codeaid
If Harvest integration is enabled, you can track the candidate progress in detail by clicking on Activity Feed in Greenhouse.
You will see notes added by Codeaid while the candidates progresses through his tests
Note: Vidya R V was the selected user ID in our case, that’s why Codeaid action are taken on her behalf.
Custom fields and activity feed will display values only if the Harvest API is enabled. If Harvest API is disabled, the custom field will be blank and activity feed will be missing many events.
In case there was an error during sending a test to candidate, Codeaid will add a note to the candidate activity feed about the exact error that happened.
If you have enabled the Harvest integration, you are able link Codeaid candidates with Greenhouse using Greenhouse candidate URL.
Log in to your Greenhouse account.
Open the Candidates page from the navigation bar.
Select an existing candidate or add a new one.
Copy the URL on the address bar
The copied link will be used in the next steps.
The next steps depends on whether the candidate on Codeaid exist already or not.
If the candidate has not yet been invited to Codeaid
Log in to your Codeaid account.
From the sidebar, click Activities.
Select Invite Candidate.
Fill out the invite form and paste the ATS link into the appropriate field.
Click Invite after confirming your choices.
View the invited candidate.
You can see that the ATS button is active and blue in color. Clicking it will open the candidate url in Greenhouse.
If the candidate was already invited from Codeaid
Log in to your Codeaid account.
From the sidebar, click Activities.
Click on the candidate’s name to view their details.
Click the ATS button, which is inactive and grey in color.
A pop-up will appear.
Paste the candidate URL.
Click Save.
The candidate will be linked successfully in a few minutes and the ATS button will turn blue. Clicking it will open the candidate URL in Greenhouse.
Additional resources
For additional information not covered here, reach out to contact@Codeaid.io.