How do I enable and use the CodeSignal integration?

Follow
Available for User roles Super Admins, Admins
Plans Starter, Enterprise, Professional

Please Note

This Partner Integration will be available as part of the Fall 2020 Release. You may not see this functionality in your account until October 8th. We appreciate your patience as we roll out the release.

Using the CodeSignal integration

Send CodeSignal Certification Requests and Tests from Lever

You can send your candidates CodeSignal Certifications requests and CodeSignal Tests invitations directly from Lever. Once your candidates complete their assessments, their results will be automatically added to the respective candidate's profile in Lever.

  1. Open the candidate's profile in Lever and make sure that the candidate's stage is one of the "Trigger Stages" defined during your integration set-up process. (e.g. Phone Screen, CodeSignal Test, etc.)
    Screen_Shot_2020-09-11_at_3.24.29_PM.png

  2. Click the CodeSignal assessment selection link on the right side of the profile.
    Screen_Shot_2020-09-11_at_3.23.49_PM.png
  3. You'll be taken to a CodeSignal page on a new browser tab. Select an assessment of your choice (Certify or Test). Then, click the "Send Invitation" button.
    Screen_Shot_2020-09-11_at_3.23.24_PM.png
    That's it! It should have sent out an invitation to your candidate and you will see the confirmation message.
    Screen_Shot_2020-09-11_at_3.23.01_PM.png
  4. Return to Lever and click the "Notes" tab on the candidate's profile. You will see that a new note about CodeSignal Assessment has been added. The initial CodeSignal assessment selection link will be removed from the profile once a CodeSignal assessment is sent. 
    Screen_Shot_2020-09-11_at_3.22.33_PM.png
  5. Once your candidate completes the CodeSignal assessment, the result will be automatically sent to Lever. You will see a new note in the candidate's profile with the following information:
    Test Name
    Date Completed
    Score
    Link to the assessment result
    Screen_Shot_2020-09-11_at_3.21.52_PM.png

Enable the CodeSignal integration

Generate a Lever API Key for the Lever/CodeSignal Integration

Your Lever API key will grant CodeSignal's system access to the specified data in your Lever account.

  1. Navigate to the Settings > Integrations and API page in Lever.
  2. Scroll down to the "Assessments" section and click the toggle for CodeSignal.
  3. The toggle icon will turn orange, and the section will expand. Click the "Generate New Key" button. The system will inform you which permissions the integration with CodeSignal will authorize. 
    Screen_Shot_2020-09-11_at_3.25.49_PM.png
  4. Navigate to the Lever ATS Credentials page on CodeSignal. Then paste the API key and test it by clicking the Test button. Once the test is successful, click Save.
    Screen_Shot_2020-09-11_at_3.26.17_PM.png
    Screen_Shot_2020-09-11_at_3.26.48_PM.png

Enter Your Lever Webhook Signing Token to CodeSignal

A webhook signing token allows Lever's system to confirm that the requests made by CodeSignal on behalf of you are authorized by you. 

  1. Click the "Webhooks" tab.
    Screen_Shot_2020-09-11_at_3.27.21_PM.png
  2. Scroll down to the "Webhook signing token" section. Then, copy the value shown under "Signature Token."
    Screen_Shot_2020-09-11_at_3.27.51_PM.png
  3. Paste the webhook signing token to the Credentials section on the CodeSignal Lever Integration page. Click Save.
    Screen_Shot_2020-09-11_at_3.28.14_PM.png

Customize the Lever/CodeSignal Integration

  1. Update the Notification Setting: You can trigger notifications to all Lever users following a candidate when an assessment note is posted to the candidate. In the Assessment Results Notification dropdown, choose your preferred notification setting.
    Screen_Shot_2020-09-11_at_3.28.36_PM.png
  2. Choose Trigger Stages: Navigate to the Configuration tab and add all stages that you want to trigger a CodeSignal assessment in the Choose Trigger Stages field. Whenever a candidate is moved into one of the selected stages in Lever, a CodeSignal assessment selection link will be added to the corresponding Lever opportunity.
    Screen_Shot_2020-09-11_at_3.29.06_PM.png
  3. Choose the Default Lever User: Under the Choose Default Lever User dropdown select the user from your Lever account who you want to display as the author of the notes and other resources created by the CodeSignal integration. (You can also create and use a dummy account like CodeSignal Integration to clarify that these notes are written automatically.)
    Screen_Shot_2020-09-11_at_3.29.31_PM.png

Configure the Candidate Stage Change Webhook in Lever

This step allows your Lever account to automatically inform CodeSignal about candidate stage change events. CodeSignal will then check these events for any match with the "trigger stages" you've selected in the previous step as those events take place.

  1. Navigate to the CodeSignal Lever Integration page and copy the value displayed in the Webhook URL field.
    Screen_Shot_2020-09-11_at_3.30.10_PM.png
  2. Navigate to the Settings > Integrations and API page in Lever.
  3. Click the "Webhooks" tab to go to the "Webhook configuration" section. Click the toggle for "Candidate Stage Change" and click the "+ Add webhook" button.
    Screen_Shot_2020-09-11_at_3.30.44_PM.png
  4. Add your configuration URL and click the "Verify Connection" button.
    Screen_Shot_2020-09-11_at_3.31.04_PM.png
    Once you see that the connection is verified, you are all set.

Was this article helpful?
0 out of 0 found this helpful