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

• ✨ Create Employee Action Update: The response of the POST /hris/employees/form action has been updated for future flexibility. The prehire_id field has been replaced by a prehire object containing a remote_id (e.g., prehire.remote_id).

Other Updates

• BoondManager: Added support for the Passthrough API, allowing you to directly access the BoondManager API for advanced use cases.
• Gusto: Updated our integration to use the latest API versions to ensure continued reliability.
• Iris Cascade: Improved mapping for employment statuses such as "At Work" and statutory leave.
• Nmbrs:
  • Manager mapping is now more accurate, especially for organizations with multiple companies.
  • Added a new setting to identify custom fields by name instead of ID, providing more flexibility.
• Okta: Improved validation for employee start dates to ensure better data quality.
• Paylocity:
  • Syncs are now faster and more reliable, particularly for customers with multiple companies.
  • Improved error handling for the create-employee form action.
• UKG Pro & UKG Ready: The in-app guidance for setting up a fast-track partnership has been updated with new instructions.
• Workday: Enhanced support for syncing custom objects by expanding the required permissions in the connection flow.

Highlights

• 📊 Cornerstone Talentlink: The integration now syncs job descriptions, custom fields, and salary information. This provides much richer job data for your applications.

Other Updates

• AFAS: Added support for syncing job custom fields.
• Avionte: Job status mapping is improved, with the "Pipelined" status now correctly mapped to "OPEN".
• Comeet: Added the remote_url field to jobs, candidates, and applications, making it easy to link back to the source system.
• Eploy: Added support for fetching job custom fields.
• JazzHR: Now syncs the remote_created_at field for jobs.
• Jobylon: You can now sync hiring team members associated with a job.
• SuccessFactors:
  • Error messages are now clearer for missing required fields when creating a candidate.
  • Added a new setting to append additional footer text to external job descriptions.
  • Improved performance of the create-candidate action by fetching less job data.
• UKG Pro & UKG Ready: The in-app guidance for setting up a fast-track partnership has been updated with new instructions.
• Workable:
  • Added the remote_url field to jobs, candidates, and applications.
  • Proactive rate-limiting has been improved to increase the reliability of actions.

Highlights

• 📣 Action Coverage in API: The GET /v1/integrations/{integration_id} and GET /v1/tools endpoints now return detailed information about supported write actions, including which input fields are available for each action. This allows you to programmatically discover the full capabilities of an integration.
• 📜 Improved Developer Dashboard Logs: We've overhauled the logs view in your dashboard. It now features a cleaner UI with markdown formatting for better readability and more helpful error messages to accelerate debugging.
• Deprecation Notice: The sync-finished webhook is being deprecated. We recommend migrating to the more efficient data-changed webhook to receive real-time notifications for data updates.

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.

Highlights

• 🚀 Create Employees in SuccessFactors with Dynamic Forms: You can now create employees in SuccessFactors using a new, dynamically generated form. This powerful action supports the complex data requirements of SuccessFactors, including custom fields and picklists fetched directly from your customer's instance.
• ➡️ Track Pre-Hires with New `remote_id` Response: The `create-employee-with-form` action now returns `remote_id` and prehire in the response. This allows you to track employees created in the remote system even before a Kombo ID is available, which is critical for pre-hire and asynchronous workflows.
• 📎 Dayforce: The create employee action now supports custom fields, allowing you to write more comprehensive employee data.

Other Updates

• 📊 UKG Pro: Added support for manager mapping when syncing employees.
• ✨ Nmbrs: The Passthrough API is now available, allowing you to make direct calls to the Nmbrs SOAP API.

Highlights

• 🚀 New UKG Ready ATS Integration: We've launched a new integration with UKG Ready's Applicant Tracking System. It supports syncing jobs and application stages, creating candidates, and moving applications through your recruitment pipeline.

Other Updates

• 📎 Jobvite: Added full support for custom fields on candidates and applications. You can also now retrieve application attachments and map candidate phone numbers.
• 📎 iCIMS: Added support for global job stages, providing more accurate recruitment pipeline data.
• 📎 Manatal: The Passthrough API is now available for Manatal.
• 📊 Personio: You can now fetch job postings in multiple languages by configuring them in the integration settings.
• 📊 Workable: Extended the candidate model to include confidentiality status.

Highlights

• 📣 Official TypeScript & Python SDKs: We've launched official SDKs for TypeScript and Python to make integrating with Kombo even faster. Our documentation has been updated with code samples for both languages directly on the endpoint pages to help you get started.
• 🔎 Revamped Logs Filtering: The Logs page in your dashboard has been significantly improved with powerful new filtering capabilities. You can now filter interactions by integration, action type, status, and other tags, making debugging much faster and more intuitive.
• 🌍 “Open in Remote System” Links in Data Explorer: You can now jump directly from a record in the Kombo Data Explorer to the corresponding page in your customer's HR system. These new deep links are available for candidates, jobs, and applications across many integrations.

Other Updates

• 💅 Dashboard response viewers in the Data Explorer and API explorer now feature syntax highlighting and auto-formatting for JSON and XML, improving readability.
• 📋 In the logs viewer, the “Copy” button for request bodies now copies the full, untruncated content, making it easier to work with large payloads.
• 🏷️ The integration catalog now more clearly indicates which integrations require a custom plan.
• ⚡️ We've improved our remapping engine to better handle structured data (like addresses) where all fields are null.

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.