Back to blogIntegration

    SmartRecruiters Integration Guide

    May 7, 2026

    Integrating Codeaid with SmartRecruiters makes it easy to include real coding assessments as part of your hiring workflow. With this integration, you can add Codeaid assessments directly to a job's interview plan, send tests to candidates without leaving SmartRecruiters, and automatically receive results and detailed reports right on the candidate's profile. This streamlined process helps hiring teams quickly identify top performers and make data-driven decisions with less manual effort.

    Integration Setup and Enablement in Codeaid

    1. 1

      Log in to your Codeaid account as an Owner/Admin.

      Step 1
    2. 2

      Open Settings > Integrations.

      Step 2
    3. 3

      Locate the SmartRecruiters integration card and click the three dots.

      Step 3
    4. 4

      Click Integrate.

      Step 4
    5. 5

      Codeaid will prompt you to confirm your password for security reasons.

      Step 5
    6. 6

      Enter your account password and click Confirm.

      Step 6
    7. 7

      A confirmation pop-up will appear, stating that you are integrating your Codeaid organization with SmartRecruiters. Click Yes to continue.

      Step 7
    8. 8

      You will then be provided with a newly created API key.

      Step 8
    9. 9

      Copy the API key by clicking on the copy icon or manually selecting the key.

      Step 9

    Note: If you accidentally close the pop-up, don't worry — you can reopen it by clicking Integrate again (refer to Step 4).

    Enabling Integration via the Apps & Integrations Page in SmartRecruiters

    1. 1

      Log in to your SmartRecruiters account.

      Step 1
    2. 2

      Click the avatar icon in the user profile, then click Settings.

      Step 2
    3. 3

      Go to Scopic > Administration, click Apps and Integrations.

      Step 3
    4. 4

      Search for "Codeaid".

      Step 4
    5. 5

      Click on the Codeaid integration.

      Step 5
    6. 6

      Click Connect to initiate the process.

      Step 6
    7. 7

      Click 'Allow and Continue'.

      Step 7
    8. 8

      You will be redirected to Codeaid to enter your Codeaid API token.

      Step 8
    9. 9

      Paste the API key into the 'API Key' field in SmartRecruiters.

      Step 9
    10. 10

      Click Authorize. If there's an issue with the API key, you will see an error message. If the API key is correct, the pop-up will close.

      Step 10
    11. 11

      You will be redirected back to SmartRecruiters, where you can see that the integration is now connected.

      Step 11
    12. 12

      Back in Codeaid, the integration will take 2–3 minutes to fully activate.

      Step 12
    13. 13

      After 3 minutes, refresh the page to confirm that the integration is complete.

      Step 13

    Configuring Hiring Processes

    1. 1

      Click the User Profile avatar icon.

      Step 1
    2. 2

      Select Settings.

      Step 2
    3. 3

      Under Scopic > Configuration, click Hiring Process.

      Step 3
    4. 4

      Edit the Default Hiring Process.

      Step 4
    5. 5

      Choose any of these stages and click Add Step on any of the available stages (In Review, Interview, and Offer).

      Step 5
    6. 6

      Click Add Custom.

      Step 6
    7. 7

      Enter a custom step name and click Add.

      Step 7
    8. 8

      The new step will be added to the selected stage.

      Step 8
    9. 9

      Click on the added step and click Assessments.

      Step 9
    10. 10

      Click Configure.

      Step 10
    11. 11

      Select the Codeaid test you want to associate with this step. Click Save.

      Step 11
    12. 12

      Enable the Auto-triggered toggle for the Codeaid test.

      Step 12
    13. 13

      Click Save to save the hiring process.

      Step 13

    Integration Workflow — Manually Triggering an Assessment

    1. 1

      Log in to your SmartRecruiters account.

      Step 1
    2. 2

      Navigate to the People page.

      Step 2
    3. 3

      Open any candidate record.

      Step 3
    4. 4

      Under Assessments, click Order Assessments.

      Step 4
    5. 5

      A pop-up listing all Codeaid tests will appear.

      Step 5
    6. 6

      From the Tests dropdown, select a Codeaid test, click Continue.

      Step 6
    7. 7

      Click Send.

      Step 7
    8. 8

      Once the candidate is invited, the pop-up will close, and you will see the assessment in pending status.

      Step 8
    9. 9

      Refresh the page to see the latest activity.

      Step 9
    10. 10

      All the activities will be recorded in the 'Notes' section as well.

      Step 10

    Integration Workflow — Automatically Triggering an Assessment

    1. 1

      Open a candidate record.

      Step 1
    2. 2

      Click the Convert button.

      Step 2
    3. 3

      The Move Forward button will now appear.

      Step 3
    4. 4

      Click the dropdown arrow next to Move Forward.

      Step 4
    5. 5

      The custom step you added will appear under the stage where you added it.

      Step 5
    6. 6

      Move the candidate to that step.

      Step 6
    7. 7

      This will automatically trigger sending a Codeaid test invitation to the candidate via email.

      Step 7

    Viewing Results in SmartRecruiters

    1. 1

      At any point during the evaluation, to view candidate details in Codeaid, click on the paper clip icon.

      Step 1
    2. 2

      This will open the candidate URL in Codeaid.

      Step 2
    3. 3

      Click 'View Report' to see the grading criteria of Codeaid.

      Step 3
    4. 4

      In Codeaid, you can see that the ATS link button is enabled and clicking it will open the candidate link in SmartRecruiters.

      Step 4
    5. 5

      In SmartRecruiters, you can track the candidate timeline in detail by clicking 'Notes'.

      Step 5

    Linking Codeaid Candidates with SmartRecruiters — Case 1: Candidate Not Yet in Codeaid

    1. 1

      Log in to your SmartRecruiters account.

      Step 1
    2. 2

      Open the People page from the navigation bar.

      Step 2
    3. 3

      Open a candidate record.

      Step 3
    4. 4

      Copy the URL on the address bar.

      Step 4
    5. 5

      Log in to your Codeaid account.

      Step 5
    6. 6

      From the sidebar, click Activities.

      Step 6
    7. 7

      Invite the candidate to a challenge or schedule an interview.

    8. 8

      You will see an 'ATS link' field where you can provide the copied URL.

    9. 9

      Fill out the invite form and paste the copied URL into the 'ATS link' field.

    10. 10

      Send the invite after confirming your choices.

    11. 11

      You can see that the ATS button is active and blue in color. Clicking it will open the candidate URL in SmartRecruiters.

    Linking Codeaid Candidates with SmartRecruiters — Case 2: Candidate Already in Codeaid

    1. 1

      In Codeaid, invite a candidate without filling in the 'ATS link' field.

    2. 2

      Click on the candidate's name to view their details.

    3. 3

      Click the ATS button, which is inactive and grey in color.

    4. 4

      'Link with ATS' pop-up will appear.

    5. 5

      Paste the candidate URL in 'ATS link' field.

    6. 6

      Click Save.

    7. 7

      The candidate will be linked successfully in a few minutes and the ATS button will turn blue.

    Need more help?

    For additional information not covered here, reach out to our support team.

    Contact Support
    Drop files here

    CodeAid Assistant

    0/2048