Smaller Updates

• 🎟️ Paycor: Your customers can now select the desired OAuth scopes during the connection flow, giving them more control over data access.
• 🤝 Perbility Helix: Added a partnership guide to the connection flow to help your customers obtain API credentials.
• 🏠 SuccessFactors: You can now configure a preferred address type (e.g., home, mailing) to be used when syncing employee addresses.

Highlights

• 🚀 Absence Data for Breathe HR: The Breathe HR integration now supports syncing absence data. You can retrieve absence types and individual employee time-off records, enabling better workforce management and analytics.
• 🔎 Filter Azure AD / Entra ID Groups: A new integration setting for Azure AD / Entra ID gives you more control over your data by allowing you to sync only security groups, excluding other types like Microsoft 365 groups.

Other Updates

• 📊 a3innuva nomina: Added support for syncing both current and historical employment contracts.
• 📊 Workday: You can now sync custom fields on the employment model.
• 🗓️ HRworks: It's now possible to configure a specific start year for fetching absence data, providing more flexibility than the default rolling three-year window.
• 🔐 UKG Pro: We've enhanced the connection flow for onboarding to more reliably capture the tenant alias.

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.