---
title: "Update integration status"
method: POST
path: "/integrations/{integration_id}/status"
tags: ["Integrations"]
---

# Update integration status

`POST /integrations/{integration_id}/status`

Enables or disables an integration.

## Path parameters

- `integration_id` string, required

## Request body

- V4IntegrationStatusRequest
  - `status` 0 | 1, required — Desired state. Only `0` (paused) and `1` (active) are accepted; `2` (error) is set exclusively by the delivery worker. To remove an integration, use `DELETE /v4/integrations/{integration_id}`.

## Response `200`

Integration status updated.

- V4Integration — A single integration record. Credentials (API keys, webhook secrets) are configured out-of-band after creation and are not exposed in this shape.
  - `object` string, required
  - `id` string, required — Integration identifier. Stable for the lifetime of the record (soft-deleted records keep their ID).
  - `url` string, required — Canonical API path.
  - `title` string, required — Caller-supplied display title.
  - `integration` string, required — Provider display title (not the lowercase slug used on create). Use for UI; for references in other requests use `id`.
  - `target_platform` 'iOS' | 'Android' | 'Stripe', required — Store the integration forwards events for. Case-sensitive.
  - `active` 0 | 1 | 2, required — Integration state. - `0` — paused / draft (no events forwarded). - `1` — active (events forwarded). - `2` — error (delivery worker suspended the pipeline; inspect `last_error_message`/`last_error_at`). Cannot be set by callers.
  - `created_at` string, date-time, required — ISO 8601 creation timestamp.
  - `updated_at` string, date-time, required — ISO 8601 last-update timestamp.
  - `last_delivery_at` string, date-time, nullable, required — ISO 8601 timestamp of the most recent successful delivery, or `null` if never delivered.
  - `last_error_at` string, date-time, nullable, required — ISO 8601 timestamp of the most recent delivery failure, or `null`.
  - `last_error_message` string, nullable, required — Human-readable description of the most recent delivery failure, or `null`.
  - `delivery_error_count` integer, required — Running count of delivery failures since the last successful delivery.

## Other responses

- `400` — Invalid integration_id or request
- `401` — Unauthorized
- `403` — Feature not available
- `404` — Integration not found
- `415` — Unsupported media type
- `429` — Rate limit exceeded
- `500` — Internal error
- `502` — Storage error
- `504` — Upstream timeout

---

[API](https://skmtc.net/qonversion/apis/qonversion-rest-api-v4.md) · [All operations](https://skmtc.net/qonversion/apis/qonversion-rest-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qonversion/qonversion-rest-api-v4/versions/e3f72cf8951c/schema)