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

• 📣 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

• 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

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

Highlights

• 🚫 Webhook Deprecation Notice: We are deprecating the RemoteEventReceived webhook. Please migrate to the more granular data-changed webhook for real-time notifications on data updates.
• 🚦 Cancel In-Progress Syncs: You can now cancel a queued or running sync directly from the Kombo dashboard. This allows you to immediately trigger a new sync without waiting for the previous one to complete.

Other Updates

• 💬 Improved Webhook Status: If a webhook event is successfully delivered to at least one of your configured endpoints, the interaction will now be marked as “Successful with warnings” instead of “Failed,” providing more accurate status reporting.
• 📄 Better OpenAPI Specification: We've significantly enhanced our OpenAPI spec to include comprehensive documentation for all webhooks, complete with payload schemas and examples for every write endpoint to improve your development experience.
• ⚡️ Faster Delta Syncs: To improve performance, we no longer run permission tests during delta syncs, making them quicker and more efficient.
• 🗺️ Documentation Improvements: We've updated our “Getting Started” guides and added new documentation for the HRIS Performance Data models.

Highlights

• 📜 Richer, More Readable Logs: We've significantly upgraded the logs view in your dashboard. We now include non-HTTP logs (like warnings and informational messages), giving you a more complete picture of your integrations' activity.

Other Updates

• 📡 Webhook Interaction Logging: Outgoing webhook calls are now tracked as their own interactions in the logs. This makes it much easier to confirm that webhooks were sent and to debug any delivery issues with your endpoints.
• 🔄 Trigger Sync from Dashboard: You can now trigger a sync for an integration directly from the field re-mapping dialog, saving you a step after you've made changes.
• 🔓 Download Decrypted SFTP Files: For SFTP integrations using PGP encryption, you can now download a decrypted version of a file directly from the dashboard.
• 🛡️ Security and Reliability Improvements: We've updated several internal dependencies, including security patches, to keep the platform secure and reliable.

Highlights

• 🔑 Enhanced API Key Security: You can now increase your security posture by applying IP address whitelisting and setting an expiry date for your API keys. These settings can be configured when creating a new key or updated for existing ones.
• 📡 Safer Integration Scope Updates: Before changing the scope configuration for an existing integration, you will now see a detailed overview of which permissions will be added or removed. This helps prevent accidental breaking changes and ensures you understand the impact of any update.

Highlights

• 🔐 New Billing Page and Role-Based Access: We've reactivated the billing page, allowing you to manage your subscription directly from the dashboard. To enhance security, access can now be granted to users of your team.
• 🗜️ More Secure Default Scopes: For new environments, we've introduced more restrictive default scope configurations. Only essential models and fields (like jobs and employees) are enabled by default, giving you more explicit control over data access from the start.

Other Updates

• ⚡ Faster and More Reliable Data Syncs: We've rolled out significant performance improvements to our data synchronization and scheduling infrastructure, resulting in faster and more reliable data fetching.

Highlights

• 🛠️ Enhanced Passthrough API in Komboman: Our developer dashboard tool, Komboman, now automatically discovers and lists available Passthrough API endpoints for each integration. You can also make requests directly from the Komboman UI, making it easier than ever to test and explore the underlying provider APIs.

Other Updates

• 📊 Database Performance Optimizations: We've added numerous database indexes across our ATS and HRIS models to accelerate data syncs and API queries.
• 🔔 Improved Dashboard Experience: The Kombo dashboard now warns you about unsaved changes, preventing accidental data loss when configuring your integrations.