---
title: "Integration state changed"
method: POST
path: "integration-state-changed"
---

# Integration state changed

`POST integration-state-changed` (webhook)

## Headers

- `X-Kombo-Signature` string, required

## Payload

- IntegrationStateChangedWebhookPayload
  - `id` string, required — Unique identifier for this webhook event
  - `type` 'integration-state-changed', required — Type of the webhook event
  - `data` object, required
    - `integration_tool` string, required — The name of the integrated tool (e.g., "personio", "greenhouse").
    - `integration_id` string, required — The unique identifier of the integration.
    - `integration_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.
    - `qa_status` 'PENDING' | 'FAILED' | 'PASSED', required — The quality assurance status of the integration.
    - `setup_status` 'INCOMPLETE' | 'FINAL_SYNC_PENDING' | 'COMPLETED', required — The current status of an integration that has filtering, field mapping features or required setup steps.
    - `state` 'ACTIVE' | 'INVALID' | 'INACTIVE', required — The current state of the integration.
    - `updated_at` string, date-time, required — ISO 8601 timestamp when the integration state was last updated.

## 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/1e45035b96d3/schema)