Assessment & Background Checks
Learn how to integrate real-time assessment data, AI insights, and ATS syncing to simplify user workflows and improve candidate evaluation
Imagine you’re developing an intelligence assessment SaaS designed to handle assessments like coding tests or psychometric evaluations for job candidates. While it may seem simple at first, integrating these assessments and syncing job data from multiple ATS systems can become complex.
Managing real-time candidate assessments across various ATS platforms requires precise data syncing and configuration, ensuring the right assessments are assigned to the correct roles and that results are handled efficiently.
Integrating Candidate Assessments Intelligence in Your SaaS: Key Steps and System Interactions
Integrating assessments into your SaaS involves syncing with multiple ATS providers, retrieving job and candidate data, and managing assessments such as coding tests or psychometric evaluations. This enables HR teams to assign, track, and evaluate candidate assessments based on specific job requirements, simplifying the hiring process.
Steps for Integrating Assessment Intelligence in Your Assessment SaaS
Below are the steps to integrate assessment intelligence into your SaaS, enabling seamless assessment management, syncing with ATS providers, and automating candidate assessments:
Automate Assessment Sync with Webhooks for Real-Time Updates
First, subscribe to the assessment webhook: Start by setting up a webhook to automatically receive notifications when new assessment orders are created. This ensures your dashboard stays updated in real time when a new assessment is triggered for a candidate.
- Webhook Event:
assessment_order.created
Next, fetch detailed candidate and job data: Once the webhook triggers, additional API calls will retrieve more information about the candidate’s application, such as id
, candidate_id
, interview_stage
, and more.
- API Endpoint: GET /ats/application/
We can also fetch job details such as id
, title
, content
, and more related to the application. This data can be used to update the dashboard with assessment and candidate details.
- API Endpoint: GET /ats/job-postings/
Enable Assessments for Candidates in Your Dashboard
Allow Users to enable different assessments: Allow users to enable a variety of assessments like coding tests, psychometric tests, and more for their candidates in the dashboard. This helps them tailor the assessments based on the job role or specific hiring needs.
- API Endpoint: GET /ats/assessments/packages
Assign Assessments to Jobs and Candidates
First, fetch active job postings: Start by pulling all active job postings from the connected ATS provider using x-account-id
in the request header. This will give you details like title
, content
, locations
, compensation
, and more.
- API Endpoint: GET /ats/job_postings
Then, configure job-specific assessments: Allow users to assign assessments to specific jobs. For instance, different coding tests can be assigned based on the role (data engineer vs. front-end engineer).
- API Endpoint: POST /ats/assessments/orders
Trigger the assessment through ATS workflow: When the candidate moves to a specific stage in the job process, allow users to trigger an assessment for the candidate using the applicant_id
parameter.
- API Endpoint: POST /ats/assessments/orders
After this, update the application status: Update the candidate’s application status using the application_status
parameter.
- API Endpoint: PATCH /ats/applications/
Notify Candidates and Manage Results with AI Insights
Send assessment details to candidates: After triggering the assessment, the dashboard will send an email notification with instructions and a link to the assessment assigned to the candidate.
AI-driven candidate analysis: Once the results are available for assessment (e.g., behavioral analysis), your SaaS can evaluate the candidate on traits like empathy, leadership, and creativity, giving a percentage score for each.
Performance report: Your SaaS can also generate a visual performance report, analyzing the candidate’s results in assigned assessments and providing users with insights through detailed graphical data.
Push the assessment results to the ATS: Finally, update the ATS provider with the assessment results, ensuring users can see the outcome directly on their dashboard whenever needed.
- API Endpoint: PATCH /ats/assessments/orders//result
The diagram below outlines the main steps involved in integrating assessments into your SaaS, from subscribing to webhooks, syncing with ATS, and assigning assessments, to update results for simplified candidate management.
Conclusion
This walkthrough showed how to integrate assessment features into your SaaS platform, making it easier to manage candidate assessments. With StackOne’s API and webhooks, you can sync job and candidate data from ATS platforms, assign job-specific assessments, and handle the process of sending results back to the ATS. This helps users make faster, more informed decisions, improving the overall hiring process.
Was this page helpful?