Update integration status
Enables or disables an integration.
Authorizations
Bearer authentication using the project Secret Key (prefixed with sk_), used exactly as shown in the dashboard. Endpoints that support sandbox data take an explicit environment field or parameter. All v4 public endpoints require the Secret Key — see Authentication. Never expose the Secret Key in client-side code.
Path Parameters
256^[a-zA-Z0-9._-]+$Body
Desired status: active to enable delivery, inactive to pause it. No other value is accepted.
To remove an integration, use DELETE /v4/integrations/{integration_id}.
active, inactive "active"
Response
Integration status updated.
A single integration record. Credentials (API keys, webhook secrets) are configured out-of-band after creation and are not exposed in this shape.
"integration"
Integration identifier.
"gNl6hyM6"
Canonical API path.
"/v4/integrations/gNl6hyM6"
Caller-supplied display title.
"Amplitude — Production iOS"
Provider display title (not the lowercase slug used on create). Use for UI; for references in other requests use id.
"Amplitude"
Store the integration forwards events for. Case-sensitive.
iOS, Android, Stripe Integration status (open enum).
active— Delivery to the destination is enabled.inactive— Delivery to the destination is paused. New integrations start with this status.error— Delivery to the destination is suspended; fix the destination credentials and set the status back toactive.deleted— The integration was deleted.
POST /v4/integrations/{integration_id}/status accepts active and inactive.
"inactive"
ISO 8601 creation timestamp.
"2026-02-26T16:03:09Z"
ISO 8601 last-update timestamp.
"2026-02-26T16:03:09Z"
ISO 8601 timestamp of the most recent successful delivery, or null if never delivered.
"2026-04-22T10:12:33Z"
ISO 8601 timestamp of the most recent delivery failure, or null.
Human-readable description of the most recent delivery failure, or null.
Running count of delivery failures since the last successful delivery.
x >= 0