> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kombo.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Issue types

> All customer-visible issue types Kombo can raise, and when they are created and resolved.

Kombo [raises an issue](./issues) 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`](../guides/webhooks#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.
