Skip to main content
Kombo raises an issue when a condition is true and resolves it when that condition clears. This page lists every customer-visible type. Internal-only types are not included. issue.type on the issue-status-changed webhook is the identifier shown under each heading. We add types over time, so your handler should treat issue.type as an open set and not fail on unknown values.

Authentication failed

Type: integration.authentication_failed Raised when Kombo cannot authenticate with the connected tool. That happens when a sync’s connection test fails with an authentication error, or when a scheduled OAuth credential refresh fails because the credentials are invalid. Rate limits during a sync do not raise this issue. Resolved when a later sync successfully tests the connection, or when OAuth credentials refresh successfully.

Action failing

Type: integration.action_failing Raised when at least 50% of the finished calls for a specific action on an integration have failed in the last 24 hours, and there have been at least 5 finished calls in that window. Kombo checks this after each action call. Resolved when a later check finds fewer than 5 finished calls in the window, or a failure rate below 50%. If the action is not called again, the issue also resolves 24 hours after it was last raised.

Incoming webhooks failing

Type: integration.incoming_webhook_failing Raised when at least 50% of the incoming webhooks for an integration have failed in the last 6 hours, and there have been at least 5 incoming webhooks in that window. Kombo checks this after it receives a webhook from the tool. Resolved when at least 5 incoming webhooks in the last 6 hours have a failure rate below 50%. It stays open if webhooks stop, or if fewer than 5 have arrived in the window.