Set up and manage Codility assessments

• You need an active Codility account with API access enabled.
• Only users with Admin access on the Employment Hero platform can set up or disconnect the integration.
• Assessments can only be added to custom hiring stages. They cannot be added to the default Apply, Interview, or Offer stages.
• Candidates must have a valid email address on their profile to receive a Codility invitation.

1. Click Settings on the left-hand side menu.
2. Under Security & Access Control, click Add-ons.
   • You must be an admin to access the Add-ons settings.
3. Find Codility (Recruitment) in the list.
4. Click the Connect button for it.
5. The Connect to Codility modal will open. Follow the steps shown in the modal:
   • Log in to your Codility account.
   • Navigate to Apps & Integrations > Custom Integrations.
   • Create an app to generate your API key.
   • Copy your API key.
6. Paste your API Token into the API Token field.
7. Click the Verify button.
8. Once the token shows as Verified, click the Connect button.

The integration is now active. You can begin configuring assessments on your job hiring processes.

Once the integration is set up, you can assign a Codility test to a specific stage in a job's hiring process.

1. Click Recruitment on the left-hand side menu.
2. Click the Recruitment submenu.
3. Click the job you need.
4. Click the three dots (...) button on the upper right side of your screen.
5. Click Edit hiring process.
6. Click the hiring stage you need.
7. Scroll to the Codility tile.
8. Click the Choose a test dropdown field.
9. Select the test you want to use.
10. (Optional) Enable Auto-send to automatically send the assessment invitation to a candidate as soon as they are moved into this stage.
11. Click the Save button.

You can only have one active Codility assessment per hiring stage. If you need to change the test, select a new one from the dropdown and save again.

You can send an assessment invitation to an individual candidate directly from their profile.

1. Click Recruitment on the left-hand side menu.
2. Click the Recruitment submenu.
3. Click the job you need.
4. Find the candidate you want to assess.
5. Ensure the candidate is in the hiring stage that has a Codility assessment configured.
6. Click the send assessment button (paper aeroplane icon) from the candidate toolbar or actions menu.
7. In the Confirmation pop-up, click the Continue button.
   • An assessment invitation can only be sent once per candidate per stage. If an invitation has already been sent, the option will not be available.

The candidate will receive an email invitation from Codility with a link to complete their test. The assessment status will update to "Invited" on their profile.

If you have enabled Auto-send on a hiring stage, the assessment invitation is sent automatically when a candidate is moved into that stage — no manual action is needed.

Auto-send must be enabled on the stage before moving the candidate. To set this up, see the tab Configure an assessment on a job's hiring process.

1. Click Recruitment on the left-hand side menu.
2. Click the Recruitment submenu.
3. Click the job you need.
4. Find the candidate you want to assess.
5. Move the candidate into the hiring stage that has Auto-send enabled. You can do this by:
   • Dragging the candidate card to the stage in the pipeline view, or
   • Opening the candidate's profile and selecting the stage from the Move to stage dropdown.
6. The assessment invitation will be sent to the candidate automatically.

The candidate will receive an email invitation from Codility with a link to complete their test. The assessment status will update to "Invited" on their profile.

You can send assessments to up to 100 candidates at once. If you need to send to more, you can repeat the process in batches.

1. Click Recruitment on the left-hand side menu.
2. Click the Recruitment submenu.
3. Click the job you need.
4. Go to the hiring stage that has a Codility assessment configured.
5. Tick the checkboxes beside the names of the candidates you want to assess.
6. Click the Send Assessment button from the bulk actions menu.

Employment Hero will queue assessment invitations for all eligible candidates. Any candidates who have already received an invitation for this stage will be automatically skipped.

Once a candidate completes their assessment, their results will appear automatically in Employment Hero.

1. Click Recruitment on the left-hand side menu.
2. Click the Recruitment submenu.
3. Click the job you need.
4. Find the candidate you need.
5. Click the Evaluation tab.
6. Scroll to the Assessments section. You will see a card for each assessment sent, showing:
   • Test name and hiring stage.
   • Status - one of: Invited, In Progress, Completed, or Expired.
   • Score - the candidate's result as a percentage (shown once the test is complete).
   • Assessment Report - a link to the full detailed report on Codility's platform.

The Assessment Report link opens in Codility's platform. You may need a Codility account to access the full report.

Here are the different assessment statuses and what they mean:

• Invited - The assessment invitation has been sent to the candidate.
• In Progress - The candidate has started but not yet finished the assessment.
• Completed - The candidate has submitted their assessment. Results are available.
• Expired - The candidate did not complete the assessment before the invitation expired.
• Invitation Failed - The invitation could not be sent. Check that the candidate has a valid email address on their profile.

Disconnecting Codility will remove the integration from your account. Assessments already sent to candidates will not be affected, but you will no longer be able to send new assessments.

1. Click Settings on the left-hand side menu.
2. Under Security & Access Control, click Add-ons.
   • You must be an admin to access the Add-ons settings.
3. Find Codility (Recruitment) in the list.
4. Click the Actions dropdown button for it.
5. Click Disconnect.
6. A disconnect confirmation pop-up will appear. Click the Disconnect button.

The integration is now disabled. To reconnect at any time, follow the steps in the Set up the Codility integration tab.