Context
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 creating more flexible Pre-Screens, Certify will no longer exist as a standalone product. CodeSignal will automatically migrate all Certify data to Pre-Screens and preserve all ATS integrations.
However, users 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: You will not have to make any changes if you are leveraging Pre-Screen (Test) GraphQL & Webhook notifications for custom Pre-Screen (Test) assessments only.
Certify GraphQL
For detailed documentation on CodeSignal’s GraphQL API, please visit this page.
Step 1 - Identify which queries you want to make
You will need to make several new Pre-Screen GraphQL queries in order to perform the actions through Pre-Screen’s GraphQL API as you did through Certify’s GraphQL API.
You will want to make the following Pre-Screen GraphQL queries:
- Query
companyTestSession(id: ID!): CompanyTestSession
to see result data for a candidate’s Pre-Screen session.- Use
verificationStatus: VerificationStatus
field to see status of a candidate’s assessment session. - Use
result: CompanyTestSessionResult
field to see information about the completed test session. - Use
versionedCodingScore: VersionedCodingScore
field onCompanyTestSessionResult
to see the candidate’s Assessment Score result data.
- Use
- Query
companyTest(id: ID!): CompanyTest
to see information about a Pre-Screen. - Query
companyTests(companyId: ID, first: Int!, offset: Int): CompanyTests!
to see a list of all Pre-Screen assessments in your organization. - Query
createCompanyTestSession(sessionFields: TestSessionInput!): CompanyTestSession
to create a new invitation to a Pre-Screen assessment. - Query
deleteCompanyTestSession(id: ID!, sendNotificationEmail: Boolean): ID!
to delete an invitation to a Pre-Screen assessment.
Step 2 - Create the GraphQL Integration
To integrate with CodeSignal’s GraphQL API, follow the steps outlined here.
Step 3 - Test the GraphQL Integration
You can write GraphQL queries directly from CodeSignal’s product UI. If you have a sandbox account, you may also use the sandbox version here.
Below is an example of a sample GraphQL query:
CodeSignal GraphQL API “Conversion” Table
Certify | Pre-Screen (Test) |
standardizedTestSession(id: ID!): StandardizedTestSession | companyTestSession(id: ID!): CompanyTestSession |
standardizedTest(id: ID!): StandardizedTest | companyTest(id: ID!): CompanyTest |
certificationRequest(requestFields: CertificationRequestInput !): CertificationRequest | companyTestSession(id: ID!): CompanyTestSession |
certificationTests(companyId: ID, first: Int!, offset: Int): CertificationTests! | companyTests(companyId: ID, first: Int!, offset: Int): CompanyTests! |
createCertificationRequest(requestFields: CreateCertificationRequestInput!): CertificationRequest | createCompanyTestSession( sessionFields: TestSessionInput!): CompanyTestSession |
revokeCertificationRequest(requestFields: CreateCertificationRequestInput!): CertificationRequest | deleteCompanyTestSession( id: ID!, sendNotificationEmail: Boolean): ID! |
Assessment Score: N/A | companyTestSessions(companyTestId: ID!, first: Int, offset: Int): [CompanyTestSession]! |
Questions? Email support@codesignal.com for assistance.