---
title: "Create a flag import configuration"
method: POST
path: "/api/v2/integration-capabilities/flag-import/{projectKey}/{integrationKey}"
tags: ["Flag import configurations (beta)"]
---

# Create a flag import configuration

`POST /api/v2/integration-capabilities/flag-import/{projectKey}/{integrationKey}`

Create a new flag import configuration. The `integrationKey` path parameter identifies the feature management system from which the import occurs, for example, `split`. The `config` object in the request body schema is described by the global integration settings, as specified by the <code>formVariables</code> in the <code>manifest.json</code> for this integration. It varies slightly based on the `integrationKey`.

## Path parameters

- `projectKey` string, string, required — The project key
- `integrationKey` string, string, required — The integration key

## Request body

- FlagImportConfigurationPost
  - `config` FormVariableConfig, required
  - `tags` string[] — Tags to associate with the configuration
  - `name` string — Name to identify the configuration

## Response `200`

Flag Import Configuration response

- FlagImportIntegration
  - `_links` FlagImportIntegrationLinks, required
    - `self` Link, required
      - `href` string
      - `type` string
    - `parent` Link, required
      - `href` string
      - `type` string
    - `project` Link, required
      - `href` string
      - `type` string
  - `_id` string, required — The integration ID
  - `integrationKey` 'split' | 'unleash', required — The integration key
  - `projectKey` string, required — The project key
  - `config` FormVariableConfig, required
  - `tags` string[], required — List of tags for this configuration
  - `name` string, required — Name of the configuration
  - `version` integer, required — Version of the current configuration
  - `_access` Access
    - `denied` AccessDenied[], required
      - `action` string, required
      - `reason` AccessDeniedReason, required
        - `resources` string[] — Resource specifier strings
        - `notResources` string[] — Targeted resources are the resources NOT in this list. The <code>resources</code> and <code>notActions</code> fields must be empty to use this field.
        - `actions` ActionSpecifier[] — Actions to perform on a resource
        - `notActions` ActionSpecifier[] — Targeted actions are the actions NOT in this list. The <code>actions</code> and <code>notResources</code> fields must be empty to use this field.
        - `effect` 'allow' | 'deny', required — Whether this statement should allow or deny actions on the resources.
        - `role_name` string
    - `allowed` AccessAllowedRep[], required
      - `action` string, required
      - `reason` AccessAllowedReason, required
        - `resources` string[] — Resource specifier strings
        - `notResources` string[] — Targeted resources are the resources NOT in this list. The <code>resources</code> and <code>notActions</code> fields must be empty to use this field.
        - `actions` ActionSpecifier[] — Actions to perform on a resource
        - `notActions` ActionSpecifier[] — Targeted actions are the actions NOT in this list. The <code>actions</code> and <code>notResources</code> fields must be empty to use this field.
        - `effect` 'allow' | 'deny', required — Whether this statement should allow or deny actions on the resources.
        - `role_name` string
  - `_status` FlagImportStatus, required
    - `status` 'complete' | 'importing' | 'pending' | 'failed' | 'partial' — The current status of the import integrations related import job
    - `lastImport` integer
    - `lastError` integer
    - `errors` StatusResponse[]
      - `integrationId` string
      - `message` string
      - `statusCode` integer
      - `timestamp` integer

## Other responses

- `400` — Invalid request
- `401` — Invalid access token
- `403` — Forbidden
- `404` — Project not found
- `409` — Status conflict
- `429` — Rate limited

---

[API](https://skmtc.net/launchdarkly/apis/launchdarkly-rest-api.md) · [All operations](https://skmtc.net/launchdarkly/apis/launchdarkly-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/launchdarkly/launchdarkly-rest-api/versions/69c5c9aafe78/schema)