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.

Highlights

• 📎 Support for Result Attachments: You can now include attachments, such as PDF reports, when writing back assessment results. This is now supported for SmartRecruiters and SAP SuccessFactors.

Other Updates

• New Features & Improvements:
  • 📊 Workday: You can now sync the hiring team members associated with an assessment order.
  • ⚙️ Ashby: Added a new integration setting to ignore assessment results with an `OPEN` status, which can prevent assessments from being prematurely marked as complete.
  • ⚙️ Recruitee: The connection flow now displays the specific webhook URLs that your customers need to use during setup, simplifying the configuration process.
• Integration Fixes:
  • 🐛 Workday: We now correctly handle and skip assessment orders for candidates that have been purged, preventing sync errors.
  • 🐛 Jobylon: The integration now ignores incoming webhooks that are not related to candidates, preventing erroneous assessment orders from being created.

Highlights

• 🔍 Support for Background Checks: To better reflect its capabilities, the Assessment API is now also explicitly positioned for Background Checks. We've updated our documentation to clarify its use for both assessment and background check providers.

Highlights

• 🕵️ Background Checks Now Supported via Assessment API: The Assessment API has been expanded to officially support background check workflows. Our documentation has been updated to guide you through configuring packages and processing orders for both assessments and background checks.
• 🤝 Workday: Added full support for background checks. You can now sync background check orders from Workday and write background check packages back into the system.

Other Updates

• 🧾 Redacted orders are now correctly excluded from the `get-open-orders` endpoint, ensuring you only receive active orders.
• ⚡ Greenhouse: Improved performance and reliability when fetching assessment data.