Create integration configuration | LaunchDarkly

curl -X POST https://app.launchdarkly.com/api/v2/integration-configurations/keys/integrationKey \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Example integration configuration",
  "configValues": {
    "optional": "an optional property",
    "required": "the required property",
    "url": "https://example.com"
  }
}'

{
  "_links": {},
  "_id": "string",
  "name": "Example Datadog integration",
  "_createdAt": 1,
  "_integrationKey": "datadog",
  "tags": [
    "testing"
  ],
  "enabled": true,
  "_access": {
    "denied": [
      {
        "action": "string",
        "reason": {
          "effect": "allow",
          "resources": [
            "proj/*:env/*;qa_*:/flag/*"
          ],
          "notResources": [
            "string"
          ],
          "actions": [
            "*"
          ],
          "notActions": [
            "string"
          ],
          "role_name": "string"
        }
      }
    ],
    "allowed": [
      {
        "action": "string",
        "reason": {
          "effect": "allow",
          "resources": [
            "proj/*:env/*;qa_*:/flag/*"
          ],
          "notResources": [
            "string"
          ],
          "actions": [
            "*"
          ],
          "notActions": [
            "string"
          ],
          "role_name": "string"
        }
      }
    ]
  },
  "configValues": {},
  "capabilityConfig": {},
  "snowflakeSetupScript": "string"
}

Create a new integration configuration. (Excludes persistent store and flag import configurations.)

Authentication

Authorizationstring

API Key authentication via header

Path parameters

integrationKeystringRequiredformat: "string"

The integration key

Request

This endpoint expects an object.

namestringRequired

The name of the integration configuration

configValuesmap from strings to anyRequired

The unique set of fields required to configure the integration. Refer to the formVariables field in the corresponding manifest.json at https://github.com/launchdarkly/integration-framework/tree/main/integrations for a full list of fields for the integration you wish to configure.

The unique set of fields required to configure the integration. Refer to the <code>formVariables</code> field in the corresponding <code>manifest.json</code> at https://github.com/launchdarkly/integration-framework/tree/main/integrations for a full list of fields for the integration you wish to configure.

enabledbooleanOptional

Whether the integration configuration is enabled. If omitted, defaults to true

tagslist of stringsOptional

Tags for the integration

capabilityConfigobjectOptional

The capability configuration for the integration

Response

Integration Configuration response

_linksmap from strings to objects

The location and content type of related resources

_idstring

The unique identifier for this integration configuration

namestring

A human-friendly name for the integration

_createdAtlong

The time the integration configuration was created

_integrationKeystring

The type of integration

tagslist of strings

An array of tags for this integration

enabledboolean

Whether the integration is currently active

_accessobject

Details on the allowed and denied actions for this integration configuration

configValuesmap from strings to any

Details on configuration for an integration of this type. Refer to the formVariables field in the corresponding manifest.json for a full list of fields for each integration.

capabilityConfigobject

The capability configuration for the integration

snowflakeSetupScriptstring

Consolidated SQL script for Snowflake Warehouse Native Experimentation setup. Present only for setup endpoint responses.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

429

Too Many Requests Error