Please be aware that this page covers upstream webhooks. These are webhooks that Kombo receives from the connected ATS/HRIS such as Personio or Recruitee. If you try to understand webhooks that Kombo sends to your system for new integrations or finished syncs, check out this page.

​
Concept

Kombo subscribes to webhooks of the systems that your customers connect. We call this feature upstream webhooks. The goal of this system is to enable you to receive data in real-time without waiting for a normal sync to complete.

​
Setup

Upstream webhooks are available for a limited set of integrations as not all integrations support them yet. We are actively working on implementing this feature for more integrations. You can check out the coverage grid to understand which integrations support this feature. This feature is enabled by default on your environment. No further configuration is needed. When this setting is enabled, Kombo will call the connected system’s API to subscribe to the webhook. You can manage the webhook subscription in the Kombo dashboard as well.

​
End-Customer Experience

For most integrations, the end-customer only needs to grant a permission to the credentials to allow us to subscribe to webhooks.

This is what the end-customer will see in the connection flow.

Kombo will also diligently only subscribe to webhook event types that are compliant with the scope config. For example, if you disable candidates and only care about jobs, we will not subscribe to any candidate events.

​
Implementation Guide

By using our Data changed webhook, you will automatically receive updates about changes we receive from upstream webhooks. That is in addition to any changes from syncs or other sources. Learn more about how to fetch from Kombo in our Fetching Data guide. Set up the downstream event in the webhook config in the Kombo dashboard. You can usually expect to receive events from the connected system within 10-20 seconds. Most systems take a few seconds before they send the webhook to Kombo. Kombo will retry the request to your system for up to 5 times with exponential backoff.

​
Troubleshooting

Check out the logs in the Kombo dashboard to see every webhook event that we receive. The downstream request will also be logged there with any warnings or errors that we encountered while processing or forwarding the event.