Highlights

• 📎 Greenhouse Passthrough for Harvest V2: The passthrough API for Greenhouse now supports Harvest API v2, allowing you to access newer assessment-related endpoints not available in v1.
• 🗺️ Improved Documentation: We've enhanced our Assessment API documentation with a new visual flowchart of the entire assessment order process and clearer instructions for handling webhooks.

Updates

• ✅ Workday: We now support processing background check orders that are initiated for existing employees, in addition to new candidates.
• ⚙️ Ashby: The setup instructions in the dashboard have been updated to clarify the partner credentialing process.

Highlights

• 🚀 New Bullhorn Assessment Integration: We've launched a new integration with Bullhorn for assessments. Your customers can now order assessment packages and view results directly within Bullhorn's interface, embedded as a custom tab.

Other Updates

• 📊 Bullhorn & Eightfold: Added metadata to clarify which candidate invitation flows (manual trigger vs. bulk invite) are supported by each integration.
• ℹ️ Lever: The setup flow now includes clearer instructions to ensure the necessary "Candidate stage change" webhook is enabled in Lever.
• 🖥️ Dashboard UI: The assessment order details view in the dashboard now displays the order's `remote_id`, making it easier to cross-reference with the provider.

Updates

• 🐛 We've improved authentication error handling for more consistent and informative errors across the Assessment API.
• Introduced a new, more specific error code (CANDIDATE_EMAIL_MISSING) for when an assessment order is attempted for a candidate without an email address.
• UKG Pro: The in-app guidance for setting up a fast-track partnership has been updated with new instructions.
• Workday: To prevent errors, assessment orders are now automatically skipped for candidates who do not have an email address in Workday.

Highlights

• 🚀 Teamtailor Assessment Integration Overhaul: We've significantly improved our Teamtailor integration. It now features a new connection flow for API key authentication and offers expanded data coverage, including job location and candidate phone numbers, for a more seamless assessment workflow.

Other Updates

• 🔒 You can now redact Personal Identifiable Information (PII) from assessment orders directly from the Kombo dashboard for improved data privacy.
• ⚙️ Workday: We added a new tool in the dashboard to help you generate a CSV of your assessment packages, simplifying the setup process.
• 🐛 SmartRecruiters: Assessment result scores are now automatically rounded to the nearest integer to meet the provider's API requirements.

We're excited to share that Kombo now provides official server-side SDKs for TypeScript/JavaScript and Python! 🎉

Why use our SDKs?

Our official SDKs are the recommended way to implement Kombo and offer several key advantages:

• ✨ Ergonomic and type-safe API interactions
• 🔄 Always up to date with the latest Kombo API changes
• 💡 Auto-completion and detailed types for inputs and outputs
• 🛡️ Avoid common pitfalls with built-in best practices

Get Started

TypeScript/JavaScript

npm install @kombo-api/sdk

📦 npm | 💻 GitHub

Python

pip install kombo

📦 PyPI | 💻 GitHub

Example Usage

import { Kombo } from '@kombo-api/sdk'

const kombo = new Kombo({
  api_key: process.env.KOMBO_API_KEY,
  integration_id: 'workday:HWUTwvyx2wLoSUHphiWVrp28',
})

const result = await kombo.hris.getEmployees()

Migrating from Custom Code?

If you're currently using custom code or self-built solutions to interact with Kombo, now is a great time to migrate! Our SDKs will save you time and reduce maintenance overhead. We've created an LLM-friendly migration prompt to help automate the process. Check out our documentation for details.

More server-side SDKs are planned. Have a specific tech stack in mind? Please reach out!

Highlights

• 🚀 New Eightfold Assessment Integration: We are excited to announce our new integration with Eightfold for assessments, expanding our ecosystem of supported partners.
• ⚙️ Asynchronous Webhooks for Orders: You can now configure the assessment:order-received webhook to be delivered asynchronously. This helps prevent timeouts on your end for long-running processes and improves the reliability of order creation.

Other Updates

• SuccessFactors: You can now generate a pre-filled CSV template for assessment packages directly from the integration's settings page in the Kombo dashboard, simplifying the setup process for your customers.

Highlights

• 📎 SAP SuccessFactors: Added a new setting to forward the assessment URL directly to SuccessFactors. This allows your customers to use their own SuccessFactors templates to send assessment invitations to candidates.

Updates

• 📊 SuccessFactors: We've improved data coverage by fetching more detailed job requisition and hiring team information when you receive an assessment order.
• 🐛 Reliability Improvement: We've improved error reporting for webhook delivery failures. If an order notification cannot be delivered to your endpoint, a more specific error is now raised to help with debugging.

Highlights

• ⚡️ Faster Workday Assessment Syncs: Syncing assessment orders from Workday is now significantly faster. By implementing caching and intelligently skipping orders that have already been processed, we've greatly reduced the number of API calls needed, improving overall performance.

Other Updates

• SuccessFactors: We've added a note to our documentation to clarify that assessment information is only visible in the SuccessFactors UI after the assessment status is set to `COMPLETED`.
• Recruitee: The integration page now includes a helpful link to an end-user guide explaining how the assessment workflow functions within Recruitee.
• Greenhouse: Added a warning that the `result_url` provided when updating an assessment result must be a publicly accessible link.
• Avature: The `assessment:order-received` webhook is now always sent when an assessment is initiated, ensuring consistent notifications.