Centralize Assessment Scores and Interview Ratings in Your ATS

Implementation: Step-by-Step Technical Walkthrough

Step 1: Collect Assessment Scores in Your Platform

Before pushing scores to the ATS, structure your assessment results in a consistent format that translates clearly across different ATS platforms. Include scoring metrics, completion timestamps, assessment types, and contextual notes that help recruiters interpret results.

Step 2: Choose Your Integration Approach

Knit provides two approaches for pushing assessment scores to ATS platforms, each suited to different technical requirements and platform capabilities. Evaluate both options based on your target ATS systems and the level of control you need over data structure.

Approach 1: Passthrough API (Direct ATS API Calls)

The Passthrough API enables you to make direct API calls to the underlying ATS platform through Knit's unified interface. This approach gives you complete control over the request structure and supports any endpoint the target ATS exposes—including custom scoring fields, proprietary rating systems, or specialized evaluation modules not covered by Knit's standardized endpoints.

When to Use Passthrough:

• Target ATS has native scoring or rating APIs you want to use directly
• You need to populate custom fields specific to certain ATS platforms
• Standard note-based score sharing doesn't meet your data structure requirements
• You're willing to implement platform-specific logic for different ATS systems

API Endpoint: POST https://api.getknit.dev/v1.0/passthrough

Request Parameters:

• path (required): The endpoint path after the application's base URL
• baseUrl (optional): Override the default base URL for the application

Important Considerations:

• Consult Knit's Base URLs reference guide to construct correct paths for each ATS platform
• The path parameter should be the relative URL after the application's base URL
• You'll need to implement platform-specific request formatting for different ATS systems
• Passthrough calls require understanding the target ATS's native API structure

Approach 2: Create Note API (Standardized Score Sharing)

The Notes API provides a standardized way to attach assessment scores to candidate profiles as text-based notes. While less structured than native scoring APIs, notes work across 14+ ATS platforms with a single unified endpoint—no platform-specific code required.

When to Use Notes API:

• You want a single implementation that works across multiple ATS platforms
• Target ATS doesn't have native scoring APIs or they're difficult to implement
• Text-based score sharing meets your transparency and documentation requirements
• You prioritize development speed and broad platform support over custom data structures

API Endpoint: POST https://api.getknit.dev/v1.0/ats.candidate.note.create

Supported Platforms: Greenhouse, Lever, SAP SuccessFactors, Workable, TeamTailor, Bullhorn, Ashby, SmartRecruiters, Breezy, Zoho Recruit, BambooHR ATS, JazzHR ATS, Recruitee, Oracle Taleo, Pinpoint (14+ platforms)

Note Architecture Variations:

The API supports two note types and automatically selects the appropriate approach based on the target ATS platform's capabilities:

1. Application-Tied Notes: Notes linked to both the candidate and a specific job application (preferred when available)
2. Global Candidate Notes: Notes attached to the candidate profile independent of specific applications (fallback option)

The API attempts application-specific notes first, then falls back to global notes if the platform doesn't support application-tied notes.

HTML Formatting Support:
The Notes API supports HTML formatting for richer visual presentation within ATS platforms that render HTML in note fields. Supported HTML elements include: bold, italic, underline, links, ordered/unordered lists, and code blocks.

Platform Limitations:

• Some ATS platforms don't support note creation via API (returns HTTP 404)
• Test note creation on target platforms during development to verify support
• Not all platforms render HTML formatting—provide clean plain text alternatives

Step 3: Push Scores to Candidate Profiles in ATS

Implement the score synchronization workflow based on your selected approach. Handle platform-specific responses gracefully and implement retry logic for transient failures.

Example: Creating Assessment Score Notes

{
  "candidateId": "cand_789",
  "applicationId": "app_456",
  "content": "=== Technical Coding Assessment ===\nCompleted: 2025-01-15\nOverall Score: 89/100\n\nDetailed Breakdown:\n• Algorithm Design: 87/100\n• Code Quality: 92/100\n• Problem Solving: 88/100\n\nResult: PASS\n\nEvaluator Notes: Strong performance on data structure problems. Excellent code documentation and testing practices."
}

Key Data Models and APIs Reference

Component	Description
Passthrough API	POST https://api.getknit.dev/v1.0/passthrough - Make direct API calls to integrated ATS applications through Knit's unified interface. Requires path parameter (relative endpoint URL after base URL). Enables custom integration workflows when standard endpoints don't cover requirements.
Create Note API	POST https://api.getknit.dev/v1.0/ats.candidate.note.create - Create candidate notes with assessment scores and evaluation feedback. Supports plain text and HTML formatting. Works with 14+ platforms including Greenhouse, Lever, SAP SuccessFactors, Workable, TeamTailor, Bullhorn, Ashby, SmartRecruiters, and more.
Application-Tied Notes	Note architecture linking notes to both candidate profiles and specific job applications. System attempts this approach first when creating notes. Provides application-specific context for assessment scores tied to particular roles.
Global Candidate Notes	Note architecture attaching notes to candidate profiles independent of specific applications. Used as fallback when application-tied notes aren't supported. Ensures assessment scores appear on candidate profiles even when application-specific notes aren't available.

Wrapping Up: Build Transparent, Data-Driven Hiring Workflows

Centralize Evaluation Data in Your ATS
Scattered assessment scores across testing platforms, interview scorecards, and recruiter notes create incomplete candidate pictures that slow hiring decisions. By automatically pushing all evaluation data to the ATS, hiring teams access complete candidate histories in one place—making faster, more confident advancement and offer decisions.

Choose the Right Integration Approach
The Passthrough API provides maximum flexibility for platforms with sophisticated scoring requirements and native ATS evaluation APIs. The Notes API delivers broad platform support and rapid implementation for teams prioritizing development speed and unified workflows. Both approaches eliminate manual score transcription while maintaining data centralization.

Maintain Scoring Transparency
When assessment results automatically appear in ATS profiles immediately after completion, all hiring stakeholders—recruiters, hiring managers, interview panels—see the same evaluation data in real-time. This transparency reduces bias, enables evidence-based decisions, and creates clear documentation of candidate progression through your hiring funnel.

Scale Across 40+ ATS Platforms
Build score synchronization logic once using Knit's unified API structure, then instantly support candidates moving through Greenhouse, Lever, Workday, SAP SuccessFactors, and 40+ other ATS systems. Add new ATS integrations without rewriting your core assessment scoring workflows.