CodeSignal’s Assessment Score transition brings customers two exciting new features:

• The new Assessment Score system, which provides a stronger signal of skill across all Skills Evaluation Frameworks.
• More flexible Pre-Screens, where one can create multiple Pre-Screens backed by the same Certified Evaluation.

As a result of introducing the new Assessment Score system, Certify will no longer exist as a standalone product. CodeSignal will automatically translate all Certify data to corresponding Certified Evaluations (in Pre-Screen) and all ATS workflows will continue to operate as normal.

However, as a result of this transition, customers who are actively leveraging the Certify GraphQL and/or Webhook API will need to adjust their integration to leverage Pre-Screen GraphQL and/or Webhook API instead.

Note: This change does not apply if you are you are leveraging Pre-Screen (Test) Webhook notifications for custom assessments.

Certify Webhooks

For detailed documentation on CodeSignal’s Webhook API, please visit this page.

Step 1 - Are your Certify assessments proctored?

To begin, make sure you know whether your current Certify assessments are proctored or not. This will determine the number of Pre-Screen Webhook notifications you will want to listen to.

To determine whether your Certify assessments are proctored, navigate to the Results tab of your Certify assessments and click on the most recent result. If the result contains Proctored: Yes in the Coding Report, then your Certify assessments are proctored.

💡 Proctoring is a service CodeSignal provides to ensure the integrity of the evaluations, and prevents candidates from cheating. For more context, please refer to this article.

Step 2 - Identify which notifications you want to listen to

You will need to listen to several new Pre-Screen Webhook notifications in order to receive the same information through Pre-Screen Webhooks as you did through Certify Webhooks.

If your Certify assessments are currently proctored…

You will want to listen to the following Pre-Screen Webhook notifications:

• Listen to the companyTestSessionCreated notification, which fires whenever an invitation to a Certified Evaluation is created.
  • Note: This notification is also fired for custom Pre-Screen (Test) assessments.
• Listen to the companyTestSessionStarted notification, which fires whenever a candidate starts the Certified Evaluation.
  • Note: This notification is also fired for custom Pre-Screen (Test) assessments.
• Listen to the preScreenResultShared notification, which fires whenever a candidate reshares an existing result to complete your Certified Evaluation invitation.
• Listen to the preScreenResultVerificationPending notification, which fires whenever a candidate completes a proctored Certified Evaluation and is awaiting verification by the CodeSignal proctoring team.
• Listen to the preScreenCandidateDeclined notification, which fires whenever a candidate declines a Certified Evaluation invitation.
• Listen to the preScreenExpired notification, which fires whenever a Certified Evaluation invitation expires.
• Listen to the preScreenResultNotVerified notification, which fires whenever CodeSignal could not verify a candidate’s completed proctored Certified Evaluation.
• Listen to the preScreenResultVerified notification, which fires whenever CodeSignal verifies a candidate’s completed proctored Certified Evaluation.

If your Certify assessments are currently not proctored…

You will want to listen to the following Pre-Screen Webhook notifications:

• Listen to the companyTestSessionCreated notification, which fires whenever an invitation to a Certified Evaluation is created.
• Listen to the companyTestSessionStarted notification, which fires whenever a candidate starts the Certified Evaluation.
  • Note: This notification is also fired for custom Pre-Screen (Test) assessments.
• Listen to the preScreenResultShared notification, which fires whenever a candidate reshares an existing result to complete your Certified Evaluation invitation.
• Listen to the preScreenCandidateDeclined notification, which fires whenever a candidate declines a Certified Evaluation invitation.
• Listen to the preScreenExpired notification, which fires whenever a Certified Evaluation invitation expires.
• Listen to the companyTestSessionFinished notification, which fires whenever a candidate finishes the Certified Evaluation.
  • Note: This notification is also fired for custom Pre-Screen (Test) assessments.

💡 Reshares allow candidates to share existing results with our clients if they have already completed the same Certified Evaluation, thereby improving the candidate experience. 

Step 3 - Create the Webhook Integration

Regardless of whether your Certify assessments are proctored or not, you will need to listen to new Pre-Screen Webhook notifications. To create these new Webhook integration, please follow the steps outlined in this document.

Step 4 - Test the Webhook Integration

There are two ways to test the Webhook integration:

The Lightweight Approach

1. Visit https://webhook.site to generate a unique UQL to receive the Webhook.
2. Log into CodeSignal → click on the top-left menu → select Integrations.
3. Within the Integrations menu, select the Webhooks page.
4. Add the designated Webhook(s) outlined in Step 2 above (as outlined in this document).
5. Choose a specific Webhook notification - such as companyTestSessionStarted - and copy and paste that unique URL to the endpoint.
6. Go back to CodeSignal and invite yourself to complete a Pre-Screen assessment.
7. As a candidate, begin the Pre-Screen assessment.
8. On https://webhook.site/, you should see the companyTestSessionStarted Webhook notification displayed.

The Simulation Approach

If you want to fully simulate the entire end-to-end cycle of a Pre-Screen assessment to test each Webhook notification, event please reach out to the Solutions Engineering team at solutions@codesignal.com.

The Solutions Engineering team will grant you access to a CodeSignal sandbox account and provide you with additional guidance to complete the Pre-Screen Webhook notification testing process.

Additional API Resources

Webhook Notification Flow Diagram

CodeSignal Webhook API “Conversion” Table

Questions? Please email support@codesignal.com for assistance.