Create Integration
POST/v1/products/:productId/integrations
This endpoint creates a new Integration in a specified Product
identified by the productId
parameter, which can be obtained from the List Products endpoint.
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 where the integration should post messages.
- 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)
Request
Path Parameters
The identifier of the Product.
- application/json
- text/json
- application/*+json
Body
required
Possible values: [dataDog
, slack
, amplitude
, mixPanel
, segment
, pubNub
]
Possible values: non-empty
Name of the Integration.
parameters
object
required
Parameters of the Integration.
List of Environment IDs that are connected with this Integration. If the list is empty, all of the Environments are connected.
List of Config IDs that are connected with this Integration. If the list is empty, all of the Configs are connected.
Body
required
Possible values: [dataDog
, slack
, amplitude
, mixPanel
, segment
, pubNub
]
Possible values: non-empty
Name of the Integration.
parameters
object
required
Parameters of the Integration.
List of Environment IDs that are connected with this Integration. If the list is empty, all of the Environments are connected.
List of Config IDs that are connected with this Integration. If the list is empty, all of the Configs are connected.
Body
required
Possible values: [dataDog
, slack
, amplitude
, mixPanel
, segment
, pubNub
]
Possible values: non-empty
Name of the Integration.
parameters
object
required
Parameters of the Integration.
List of Environment IDs that are connected with this Integration. If the list is empty, all of the Environments are connected.
List of Config IDs that are connected with this Integration. If the list is empty, all of the Configs are connected.
Responses
- 201
- 400
- 404
- 429
When the creation was successful.
- application/json
- Schema
- Example (from schema)
Schema
product
object
Details of the Product.
organization
object
Details of the Organization.
Identifier of the Organization.
Name of the Organization.
Identifier of the Product.
Name of the Product.
Description of the Product.
The order of the Product represented on the ConfigCat Dashboard. Determined from an ascending sequence of integers.
Determines whether a mandatory reason must be given every time when the Feature Flags or Settings within a Product are saved.
Identifier of the Integration.
Name of the Integration.
Possible values: [dataDog
, slack
, amplitude
, mixPanel
, segment
, pubNub
]
parameters
object
nullable
Parameters of the Integration.
List of Environment IDs that are connected with this Integration. If the list is empty, all of the Environments are connected.
List of Config IDs that are connected with this Integration. If the list is empty, all of the Configs are connected.
{
"product": {
"organization": {
"organizationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "string"
},
"productId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "string",
"description": "string",
"order": 0,
"reasonRequired": true
},
"integrationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "string",
"integrationType": "dataDog",
"parameters": {},
"environmentIds": [
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
],
"configIds": [
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
]
}
Bad request.
Not found.
Too many requests. In case of the request rate exceeds the rate limits.