SmartRecruiters Integration Guide

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 platform 

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

Step 2: Open Settings>Integrations. 

Step 3: Locate the SmartRecruiters integration card and click the three dots. 

Step 4: Click Integrate. 

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

Step 6: Enter your account password and click Confirm. 

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

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

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

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

Step 1: Log in to your SmartRecruiters account. 

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

Integration setup and enablement in SmartRecruiters platform 

Step 3: Go to Scopic>Administration, click Apps and Integrations. 

Step 4: Search for “Codeaid“ 

Step 5: Click on the Codeaid integration. 

Step 6: Click Connect to initiate the process. 

Step 7: Click ‘Allow and Continue’. 

Step 8: You will be redirected to Codeaid to enter your Codeaid API token. 

Step 9: Paste the API key into the ‘API Key’ field in SmartRecruiters. 

Step 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, and you’ll see the following: 

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

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

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

Configuring hiring processes

Step 1: Click the User Profile avatar icon. 

Step 2: Select Settings. 

Step 3: Under Scopic > Configuration, click Hiring Process. 

Step 4: Edit the Default Hiring Process. 

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

Step 6: Click Add Custom. 

Step 7: Enter a custom step name and click Add. 

Step 8: The new step will be added to the selected stage. 

Step 9: Click on the added step and click Assessments.

Step 10: Click Configure. 

Step 11: Select the CodeAid test you want to associate with this step. Click Save. 

Step 12: Enable the Auto-triggered toggle for the CodeAid test. 

Step 13: Click Save to save the hiring process. 

Integration Workflow 

Step 1: User triggers the Codeaid assessment order from SmartRecruiters User manually triggers the assessment order Log in to your SmartRecruiters account. Navigate to the People page. 

Step 2: Open any candidate record. 

Step 3: Under Assessments, click Order Assessments. 

Step 4: Pop-up listing all codeaid tests will appear. 

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

Step 6: Click Send.

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

Step 8: Refresh the page to see the latest activity.

Step 9: All the activities will be recorded in the ‘Notes’ section as well.

Step 10: User automatically triggers the assessment order by moving the candidate to the pre-configured step in the Hiring Process Open a candidate record. Click the Convert button. 

Step 11: The Move Forward button will now appear. 

Step 12: Click the dropdown arrow next to Move Forward. The custom step you added will appear under the stage where you added it. 

Step 13: Move the candidate to that step. 

Step 14: This will automatically trigger sending a CodeAid test invitation to the candidate via email. Candidate receives the assessment invitation email.

Step 16: Candidate takes the assessment.

Step 17: Once completed, the results are posted back to the SmartRecruiters platform.

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

Step 19: This will open the candidate URL in Codeaid. Click ‘View Report’ to see the grading criteria of Codeaid.

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

Step 21: In SmartRecruiters, you can track the candidate timeline in detail by clicking ‘Notes’ in SmartRecruiters. 

Customization

Codeaid allows linking Codeaid candidates with SmartRecruiters using SmartRecruiters candidate URL. No additional configuration is required on the SmartRecruiters side to enable this. This functionality has already been implemented by Codeaid and will be available as soon as you enable the integration with Codeaid. 

Step 1: Log in to your SmartRecruiters account and open the People page from the navigation bar. 

Step 2: Open a candidate record and copy the URL on the address bar. The copied link will be used in the next steps. 

Step 3: Log in to your Codeaid account. From the sidebar, click Activities. 

Note: The next steps depend on whether the candidate exists already in Codeaid or not.

Case1: If the candidate has not yet been invited to Codeaid

Step 1: From Codeaid, invite Candidate to challenge or schedule interview for a candidate.

Step 2: You will see an ‘ATS link’ field where you can provide the copied url. 

Step 3: Fill out the invite form and paste the copied url into the ‘ATS link’ field. 

Step 4: Send the 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 SmartRecruiters. 

Case2: If the candidate was already invited from Codeaid.

Step 1: In CodeAid, invite a candidate without filling in the ‘ATS link’ field.

Step 2: Click on the candidate’s name to view their details.

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

Step 4: ‘Link with ATS’ pop-up will appear. 

Step 5: Paste the candidate URL in ‘ATS link’ field. 

Step 6: 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 SmartRecruiters. 

Additional resources
For additional information not covered here, reach out to contact@Codeaid.io.