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

• 🚀 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 MHM HR Integration: We've launched a new ATS integration with MHM HR. You can now sync jobs and applications, and create new candidates with attachments.
• 🔐 Improved Oracle Recruiting Connection Flow: We have overhauled the connection process for Oracle Recruiting. It now supports modern JWT-based authentication and features a guided setup process, making it easier and more secure for your customers to connect their accounts.
• ⚡️ Faster Application Syncs: The GET /ats/applications endpoint is now more performant when using the updated_after filter. Changes to the associated job will no longer cause the application to be included in the results, reducing noise and unnecessary data fetching.

Other Updates

• 📊 Pinpoint Screening Question Answers: We now sync screening question answers for applications from Pinpoint. This allows you to access detailed candidate responses directly through the API.
• 📎 Avionte: Now supports webhooks for when talent is created or tagged (talent_created, talent_tag_added). We also improved the consistency of custom job fields.
• 📊 Ashby: You can now sync the job_code field from jobs and use URL-type application questions.
• 🐛 Greenhouse: To improve sync performance, temporary signed attachment URLs are no longer stored in remote_data, reducing unnecessary updates.
• 🛠️ JazzHR: The remote_id for screening questions is now based on the question's order, making it more stable even if the question text changes.
• ⚡️ Lever: Candidate syncs are now significantly faster for large accounts by filtering for recently updated candidates.
• 📊 Workable: We now sync recruiters and associate them with jobs. The candidate headline is now more descriptive, combining title and company, and sourced_by mapping has been improved.
• 📊 Zoho Recruit: Added support for secondary email addresses when creating applications.

Highlights

• Improved Rate Limit Handling: We've enhanced our system to more accurately parse Retry-After and X-RateLimit-Reset headers from various providers. This leads to more reliable and resilient integrations by respecting provider rate limits more effectively.
• More Actionable API Error Messages: We've significantly improved validation error messages. When you provide invalid data for fields that accept multiple types (unions), the error message will now clearly detail why each type failed validation, making it much easier to debug your requests.

Other Updates

• In the dashboard, request and response logs are now displayed in a syntax-highlighted code viewer for improved readability.

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.

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

• 🚀 Workable Webhooks: The Workable integration now supports webhooks. This allows you to receive real-time updates for candidate events, including creation, stage moves, and deletions, keeping your data synchronized without waiting for the next periodic sync.
• 📎 Jobylon Screening Questions: You can now sync and answer screening questions for jobs from Jobylon, enabling a more complete application workflow.

Other Updates

• 📎 Ashby: Added support for syncing candidate location, including city, state, and country.
• 📎 Bullhorn: You can now sync candidate location details, including country. We also improved syncing of social media links from custom fields.
• 📎 Teamtailor: Added a new setting to configure whether notes on an application are sent as public or private. The connection flow instructions have also been clarified.
• Avionte: Full syncs are now scheduled less frequently to reduce API usage costs for your customers, while incremental updates continue as normal.

Highlights

• 🔌 Automatic Webhook Deactivation: To improve reliability, webhooks that consistently fail with "Not Found" errors (404/410) for 7 consecutive days will now be automatically disabled. You can view the status and re-enable them in the dashboard at any time
• 🛠️ Developer Dashboard Improvements: The dashboard now offers more powerful tools for monitoring and debugging. You can filter interactions by a specific date range and error codes. Error logs are now color-coded by severity to help you identify critical issues faster, and the log viewer has been redesigned for better performance with large log files.

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.