Create integration configuration — LaunchDarkly

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

Path parameters

integrationKeystringRequired

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.

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

_createdAtlongOptional

The time the integration configuration was created

_integrationKeystringOptional

The type of integration

tagslist of stringsOptional

An array of tags for this integration

enabledbooleanOptional

Whether the integration is currently active

_accessobjectOptional

Details on the allowed and denied actions for this integration configuration

configValuesmap from strings to anyOptional

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.

capabilityConfigobjectOptional

The capability configuration for the integration

Errors

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

1 { 2 "_links": { 3 "key": { 4 "href": "href", 5 "type": "type" 6 } 7 }, 8 "_id": "_id", 9 "name": "Example Datadog integration", 10 "_createdAt": 1000000, 11 "_integrationKey": "datadog", 12 "tags": [ 13 "testing" 14 ], 15 "enabled": true, 16 "_access": { 17 "denied": [ 18 { 19 "action": "action", 20 "reason": { 21 "effect": "allow" 22 } 23 } 24 ], 25 "allowed": [ 26 { 27 "action": "action", 28 "reason": { 29 "effect": "allow" 30 } 31 } 32 ] 33 }, 34 "configValues": { 35 "key": "value" 36 }, 37 "capabilityConfig": { 38 "approvals": { 39 "additionalFormVariables": [ 40 {} 41 ] 42 }, 43 "auditLogEventsHook": { 44 "statements": [ 45 { 46 "effect": "allow" 47 } 48 ] 49 } 50 } 51 }

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

1	{
2	"_links": {
3	"key": {
4	"href": "href",
5	"type": "type"
6	}
7	},
8	"_id": "_id",
9	"name": "Example Datadog integration",
10	"_createdAt": 1000000,
11	"_integrationKey": "datadog",
12	"tags": [
13	"testing"
14	],
15	"enabled": true,
16	"_access": {
17	"denied": [
18	{
19	"action": "action",
20	"reason": {
21	"effect": "allow"
22	}
23	}
24	],
25	"allowed": [
26	{
27	"action": "action",
28	"reason": {
29	"effect": "allow"
30	}
31	}
32	]
33	},
34	"configValues": {
35	"key": "value"
36	},
37	"capabilityConfig": {
38	"approvals": {
39	"additionalFormVariables": [
40	{}
41	]
42	},
43	"auditLogEventsHook": {
44	"statements": [
45	{
46	"effect": "allow"
47	}
48	]
49	}
50	}
51	}