---
title: "Update Integration"
method: PUT
path: "/v1/integrations/{integrationId}"
tags: ["Integrations"]
---

# Update Integration

`PUT /v1/integrations/{integrationId}`

This endpoint updates a Config identified by the `integrationId` parameter.

The Parameters dictionary differs for each IntegrationType:
- Datadog
	- `apikey`: Required. Datadog API key.
	- `site`: Datadog site. Available values: `Us`, `Eu`, `Us1Fed`, `Us3`, `Us5`. Default: `Us`.
- Slack  
	Connecting the Slack integration through the Public Management API will not post messages with the ConfigCat Feature Flags Slack app but with an incoming webhook.
	- `incoming_webhook.url`: Required. The [incoming webhook URL](https://api.slack.com/messaging/webhooks) where the integration should post messages.
	- `includeSensitiveData`: Set to "true" to include [sensitive (hashed) comparison values](https://configcat.com/docs/targeting/targeting-rule/user-condition/#confidential-text-comparators). By default, the integration will mask these values in the posted messages. We recommend hiding sensitive comparison values for shared or public Slack channels.
- Amplitude
	- `apiKey`: Required. Amplitude API Key.
	- `secretKey`: Required. Amplitude Secret Key.
- Mixpanel
	- `serviceAccountUserName`: Required. Mixpanel Service Account Username.
	- `serviceAccountSecret`: Required. Mixpanel Service Account Secret.
	- `projectId`: Required. Mixpanel Project ID.
	- `server`: Mixpanel Server. Available values: `StandardServer`, `EUResidencyServer`. Default: `StandardServer`.
- Twilio Segment
	- `writeKey`: Required. Twilio Segment Write Key.
	- `server`: Twilio Segment Server. Available values: `Us`, `Eu`. Default: `Us`.
- PubNub (work in progress)

## Path parameters

- `integrationId` string, uuid, required

## Request body

- ModifyIntegrationRequest
  - `name` string, required — Name of the Integration.
  - `parameters` object, required — Parameters of the Integration.
  - `environmentIds` string[], required — List of Environment IDs that are connected with this Integration. If the list is empty, all the Environments are connected.
  - `configIds` string[], required — List of Config IDs that are connected with this Integration. If the list is empty, all the Configs are connected.

## Response `200`

- IntegrationModel — Details of the Integration.
  - `product` ProductModel, required — Details of the Product.
    - `organization` OrganizationModel, required — Details of the Organization.
      - `organizationId` string, uuid, required — Identifier of the Organization.
      - `name` string, required — Name of the Organization.
    - `productId` string, uuid, required — Identifier of the Product.
    - `name` string, required — Name of the Product.
    - `description` string, nullable, required — Description of the Product.
    - `order` integer, required — The order of the Product represented on the ConfigCat Dashboard. Determined from an ascending sequence of integers.
    - `reasonRequired` boolean, required — Determines whether a mandatory reason must be given every time when the Feature Flags or Settings within a Product are saved.
    - `approveRequired` boolean, required — Determines whether changes must be approved before they are applied within a Product.
  - `integrationId` string, uuid, required — Identifier of the Integration.
  - `name` string, required — Name of the Integration.
  - `integrationType` 'dataDog' | 'slack' | 'amplitude' | 'mixPanel' | 'segment' | 'pubNub', required
  - `parameters` object, nullable, required — Parameters of the Integration.
  - `environmentIds` string[], required — List of Environment IDs that are connected with this Integration. If the list is empty, all of the Environments are connected.
  - `configIds` string[], required — List of Config IDs that are connected with this Integration. If the list is empty, all of the Configs are connected.

## Other responses

- `400` — Bad request.
- `404` — Not found.
- `429` — Too many requests. In case of the request rate exceeds the rate limits.

---

[API](https://skmtc.net/configcat/apis/configcat-public-management-api.md) · [All operations](https://skmtc.net/configcat/apis/configcat-public-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/configcat/configcat-public-management-api/versions/6b4d53bc1455/schema)