---
title: "Issue status changed"
method: POST
path: "issue-status-changed"
---

# Issue status changed

`POST issue-status-changed` (webhook)

Sent when a Kombo issue is raised or resolved. All customer-visible issue types use this webhook. Snoozing, snooze expiry, and updates to the message or other fields are not sent.

## Headers

- `X-Kombo-Signature` string, required

## Payload

- IssueStatusChangedWebhookPayload
  - `id` string, required — Unique identifier for this webhook event
  - `type` 'issue-status-changed', required — Type of the webhook event
  - `data` object, required
    - `change` 'raised' | 'resolved', required — Why this webhook was sent: the issue was raised or resolved.
    - `issue` object, required
      - `id` string, required — The unique identifier of the issue.
      - `type` string, required — The issue type, for example `integration.authentication_failed`. Kombo will add more types over time. Treat unknown values as valid and handle them without failing.
      - `title` string, required — A short, customer-facing title for this issue type.
      - `status` 'OPEN' | 'RESOLVED', required — The issue status after this change.
      - `markdown_message` string, required — What is wrong and how to investigate or fix it.
      - `first_observed_at` string, date-time, required — ISO 8601 timestamp when Kombo first observed this episode of the issue.
      - `resolved_at` string, date-time, nullable, required — ISO 8601 timestamp when the issue was resolved. `null` while it is open.
    - `integration` object, nullable, required — The integration this issue belongs to. `null` for environment-wide issues.
      - `id` string, required — The unique identifier of the integration.
      - `tool` string, required — The name of the integrated tool (e.g., "personio", "greenhouse").
      - `category` 'HRIS' | 'ATS' | 'ASSESSMENT' | 'LMS', required — The category of the integration (HRIS, ATS, ASSESSMENT, or LMS).
      - `end_user` object, required — Information about the end user who created the integration.
        - `organization_name` string, required — The name of the organization that owns the integration.
        - `creator_email` string, email, nullable, required — The email address of the user who created the integration.
        - `origin_id` string, nullable, required — The unique identifier of the organization in the integrated system.

## Acknowledgement `200`

Webhook received successfully

---

[API](https://skmtc.net/kombo/apis/kombo-api.md) · [All operations](https://skmtc.net/kombo/apis/kombo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kombo/kombo-api/revisions/0cfc9fa971c0/schema)
