> ## 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.

# Issues

> See which integrations need attention, and how long the problem has been going on.

An issue tracks a specific problem with an integration, such as failed
authentication. Kombo raises it when the condition is first observed, resolves
it automatically when the condition clears, and raises it again if the condition
returns.

Each issue tells you:

* what is wrong
* when Kombo first observed it and last observed it
* whether it is open, snoozed, or resolved

See [all issue types](./issue-types) for the conditions Kombo currently tracks.

## View issues in the dashboard

Open the [Integrations page](https://app.kombo.dev/integrations) in the Kombo
dashboard. The list shows an issue count for every integration with an open
issue. Hover over the count to see the title and how long Kombo has been
observing it.

<Frame>
  <img src="https://mintcdn.com/kombo/GsgKLLm-Oedz8M_n/images/issues/integrations-list.jpg?fit=max&auto=format&n=GsgKLLm-Oedz8M_n&q=85&s=251330c4dab02cc99acdd78b91cd0d5b" alt="Issues column on the integrations list" width="1800" height="799" data-path="images/issues/integrations-list.jpg" />
</Frame>

Open the integration to see the issue details.

<Frame>
  <img src="https://mintcdn.com/kombo/GsgKLLm-Oedz8M_n/images/issues/integration-page.jpg?fit=max&auto=format&n=GsgKLLm-Oedz8M_n&q=85&s=b65c1a6783bd4fc71a6e339b89daad7c" alt="Issue details on an integration" width="1800" height="590" data-path="images/issues/integration-page.jpg" />
</Frame>

You can snooze an issue to hide it in the Kombo dashboard for a while. Snoozing only affects the UI. The issue stays open, Kombo keeps observing it, and it does not send an [`issue-status-changed`](../guides/webhooks#issue-status-changed) webhook.

<Frame>
  <img src="https://mintcdn.com/kombo/IzkoAIc2nEQ18HWY/images/issues/snooze-issue.png?fit=max&auto=format&n=IzkoAIc2nEQ18HWY&q=85&s=15c155de86f915d6a0fa7b55234dc4a8" alt="Snooze issue dialog" width="1024" height="736" data-path="images/issues/snooze-issue.png" />
</Frame>

## Subscribe to issue updates

To receive issue updates in your system:

1. Open [Configuration → Webhooks](https://app.kombo.dev/configuration/webhooks)
   for the environment you want to monitor.
2. Create a webhook and select **Issue status changed**.
3. Enter the endpoint that should receive the events.

<Frame>
  <img
    src="https://mintcdn.com/kombo/IzkoAIc2nEQ18HWY/images/issues/subscribe-to-issue-updates.png?fit=max&auto=format&n=IzkoAIc2nEQ18HWY&q=85&s=fae4a244b57a0617fba3ec6667946e19"
    alt="Issue status changed webhook
configuration"
    width="1024"
    height="740"
    data-path="images/issues/subscribe-to-issue-updates.png"
  />
</Frame>

One subscription covers every customer-visible issue type. Kombo sends an
`issue-status-changed` webhook when an issue is raised or resolved. The
payload's `data.change` field is `raised` or `resolved`, and `data.issue`
contains the issue details. See the
[webhook reference](../guides/webhooks#issue-status-changed) for the full
payload, delivery behavior, and signature validation.

<CardGroup cols={2}>
  <Card title="Issue types" icon="list" href="./issue-types">
    When each issue type is raised and resolved.
  </Card>

  <Card title="Logs" icon="scroll" href="./logs">
    Inspect the requests behind a failing sync or action.
  </Card>

  <Card title="Reconnecting" icon="arrow-rotate-right" href="../guides/connect/reconnection">
    Restore credentials when authentication has failed.
  </Card>

  <Card title="Webhooks" icon="webhook" href="../guides/webhooks#issue-status-changed">
    Get raised and resolved issue events as they happen.
  </Card>
</CardGroup>
