Highlights

• 🚀 New Integration: iTrent: We're excited to announce our new HRIS integration with iTrent. This integration, currently in closed beta, supports syncing employee and employment data.
• 🚀 New Integration: HoorayHR: HoorayHR is now available as an HRIS integration. You can sync employees, employments, teams, and absences to support a wide range of HR workflows.

Other Updates

• Humaans: You can now provision new employees using the create-employee action and form.
• ADP: The create-employee form now supports selecting a job title and code.
• Google Workspace: Manager mapping is now more reliable, and permission-related errors are surfaced more clearly during connection setup.
• HiBob: We now support syncing open-ended absences. The create-employee form has also been updated to support custom list fields.
• Paylocity: The create-employee action is now more flexible, with support for cost center levels and longer usernames.

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

• 🚀 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.

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 a3innuva Nómina Integration: We've launched a new HRIS integration with a3innuva Nómina. It supports syncing employees (including historical employment data) and departments, along with an employee creation form.
• 💼 Workday Time & Attendance: You can now sync time and attendance data from Workday. This introduces support for our new Timesheets model, allowing you to retrieve worker time blocks, including approval status and comments.
• 🔐 Improved Oracle HCM Connection Flow: We've completely revamped the connection process for Oracle HCM. The new flow supports modern JWT-based authentication and provides a guided setup, simplifying the connection process for your customers.
• 📊 Employee Number on Manager Object: The manager object on an employee record now includes the manager's employee_number. This makes it easier to reference managers using their organizational ID.

Other Updates

• 🗺️ Entra ID (Azure AD): The Custom Field Explorer is now supported, allowing you to map custom employee fields.
• 🔐 Hansalog: The connection flow is now more flexible and can automatically detect the correct API URL for different customer instances.
• 📊 HiBob: The custom_fields on employments now include salary-related data.
• 📎 YouServe: You can now upload documents for employees using a new action.
• 🔐 Zoho People: The connection flow now correctly handles peopleplus.zoho.* domains.

Highlights

• 🚀 New HRIS Integration: PeopleXD (formerly CoreHR): We've added support for PeopleXD. You can now sync active employee profiles and bank account details.
• 📊 New Performance Data Model for HRIS API: We've launched a comprehensive new data model for performance management. You can now sync performance review cycles and individual reviews, including ratings and comments, from multiple HRIS providers. See the HRIS section for the list of currently supported integrations.
• 📈 Oracle HCM: The integration now supports syncing employee absences and absence types, providing more complete time-off data.
• 🚀 Self-Serve SFTP Configuration: A new self-serve workflow in the dashboard allows you to configure SFTP integrations yourself. You can now inspect files, select the correct parser (CSV, JSON, XLSX), define the employee ID column, and remap fields directly, accelerating your setup process.

Highlights

• 🔐 Certificate-Based Authentication for Azure AD & Entra ID: For app-only connections with Azure AD / Entra ID, you can now use certificate-based authentication. This provides a highly secure alternative to using client secrets.
• 🌬️ HiBob Hire API Passthrough: You can now access HiBob's Hire API directly using our Passthrough API, giving you more flexibility to build custom hiring workflows.

Other Updates

• Zoho People:
  • You can now create employees using a new, dynamic form. The integration supports both direct creation and invitation methods.
  • Added the `private_email` field to the employee model.
• UKG Pro:
  • Added support for creating employees via a new form and import tool.
  • For multinational companies, you can now configure which countries to fetch dropdown options from.
• Personio: The timesheets data model now includes support for custom fields.
• Eurecia: Employee syncs are now more reliable. We've also officially marked custom fields as supported for this integration.
• Entra ID: The user model now includes the `userType` field, allowing you to distinguish between Members and Guests.
• CezanneHR: You can now access employee bank details via custom fields.

Highlights

• 🚀 New Beta Endpoints for Performance Data: We've introduced new endpoints to access performance management data. You can now use GET /hris/performance-review-cycles and GET /hris/performance-reviews to retrieve information about review cycles and individual employee reviews.
• 📊 Custom Fields for Timesheets: The Timesheet model across the HRIS API now supports custom_fields. This allows you to sync richer, more detailed time and attendance data from connected systems.

Other Updates

Model & Action Enhancements

• Dayforce: The `create-employee` form has been significantly expanded with new fields for contact information, salary, and various company policies.
• Paylocity: Timesheet data now includes support for custom fields.
• YouServe: The employee model now includes the employee's manager_id, and name parsing has been improved for better accuracy.

Integration Enhancements & Fixes

• Employment Hero: We've improved reliability by adding better handling for the provider's API rate limits.
• Paycom: Fixed a bug where the `create-employee` action could unintentionally send welcome invites to new hires.
• SuccessFactors: Syncs are now more resilient and will no longer fail if an employee has multiple personal information records.
• 🐛 Reliability has also been improved for Dayforce and Workday syncs.

Highlights

• ⭐ SAP SuccessFactors: Improved Concurrent Employment Handling: We've significantly enhanced our SAP SuccessFactors integration to more accurately handle employees with multiple concurrent jobs. The integration now correctly identifies the primary active employment to source data like job title and manager, and maps detailed data to employee-level custom fields.
• 🚀 SAP SuccessFactors: Support for Proxied Domains: The connection flow for SAP SuccessFactors now supports connections via gateway or proxy domains, making it easier for your customers with complex enterprise network setups to connect.

Other Updates

• New Actions & Expanded Coverage:
  • 📎 Leapsome: Added a new `create-employee` action, allowing you to provision new users in Leapsome.
• Integration Improvements & Fixes:
  • 🐛 We improved the reliability of filtering employees by `group` when the group `type` field is missing from the source system.

Highlights

• 📤 File Uploads for HiBob New Hires: The `create-employee-form` action for HiBob now supports file uploads. You can now include documents like contracts or ID cards directly when creating a new employee.
• 🔐 More Reliable Azure AD Connections: We've reworked our Azure AD connection flow to use a more robust "app-only" authentication method. This provides a more stable and reliable connection for your customers, especially in enterprise environments.

Other Updates

• 📋 Dayforce: We've made significant improvements to the `create-employee-form` action, including converting free-text fields like Country and State to dropdowns for better data quality and adding new fields for Union Membership, Gender, and Base Salary.
• 🧩 BambooHR: We've expanded the field mapping for the employee form, adding better support for dropdown fields and more data types.
• 🎂 Paychex: You can now include an employee's Date of Birth when creating them via the `create-employee-form` action.
• 🐛 Reliability Improvements: We've shipped fixes and reliability enhancements for ADP Workforce Now, Factorial, Paycor, PeopleHR, and Silae.