Highlights

• 🔎 Redesigned Logs for Easier Debugging: We've completely overhauled the Logs page in the dashboard. You can now view the exact data that caused a parsing error and replay failed requests directly in our API explorer, making it much faster to debug integration issues.
• ⚡️ Faster Syncs with Optimized Filtering: We've significantly improved the performance of requests using the `updated_after` filter. This change speeds up incremental syncs for integrations with large datasets.
• 🐛 SDK Pagination Fixed: We've resolved an issue in our SDKs where the pagination cursor for the next page of results was not being extracted correctly. Please update to the latest version of the SDK to benefit from this fix.

Other Updates

• 🔌 Reconnect from Dashboard: You can now trigger a reconnection for an integration with invalid credentials directly from the Kombo dashboard, simplifying the recovery process for your customers.

Highlights

• 🗓️ New data_expired_at Field: The integration details endpoint now includes a data_expired_at timestamp. This field indicates when an integration's data has become stale, for example, after your customer updates their filter settings or scope config, and is automatically cleared after a successful sync.
• 🔎 Major Logs Page Upgrade: We've significantly enhanced the logs page in the dashboard. You can now use multi-select filters for status, type, error code, and integrations, making it much easier to drill down into specific interactions. We've also added fuzzy search to dropdowns and new filters like "Uncategorized Errors".

Highlights

• 📣 Deprecation: `remote-event-received` Webhook Removed: As previously announced, the legacy `remote-event-received` webhook has been fully removed. Please ensure you have migrated to our `data-changed` webhook, which provides more granular and reliable notifications for data updates.
• 🔐 New Webhook Secret Regeneration: For enhanced security, you can now regenerate your webhook signing secret directly from the Kombo dashboard. This allows you to easily rotate keys as part of your security protocol.
• 💅 Major Dashboard UI Upgrade: We've completely overhauled the select and filter components across the dashboard. This brings a much-improved user experience with searchable, grouped, and multi-select options, making it faster to navigate and find the information you need.

Other Updates

• ⏰ Timestamps in Logs: All entries in the request logs view now include a timestamp, making it easier to correlate events and debug issues.
• 📊 Enhanced Log Filtering: You can now filter logs by more properties.
• 🔗 Improved Webhook Data Visibility: The integrations list in your dashboard now shows when data was last updated by a webhook, giving you a more complete picture of data freshness alongside regular syncs.
• 🛠️ Improved Webhook Coverage Reporting: We've improved how we communicate the exact coverage of webhooks for each integration, providing more clarity on which events will trigger a notification.

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.