---
title: "Create a custom integration"
method: POST
path: "/api/fleet/epm/custom_integrations"
tags: ["Elastic Package Manager (EPM)"]
---

# Create a custom integration

`POST /api/fleet/epm/custom_integrations`

**Spaces method and path for this operation:**

<div><span class="operation-verb post">post</span>&nbsp;<span class="operation-path">/s/{space_id}/api/fleet/epm/custom_integrations</span></div>

Refer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.

Create a new custom integration package with user-defined data streams.<br/><br/>[Required authorization] Route required privileges: integrations-all AND fleet-agent-policies-all.

## Headers

- `kbn-xsrf` string, required

## Request body

- KibanaHTTPAPIsCreateCustomIntegrationRequest
  - `datasets` object[], required
    - `name` string, required
    - `type` 'logs' | 'metrics' | 'traces' | 'synthetics' | 'profiles', required
  - `force` boolean
  - `integrationName` string, required

## Response `200`

Successful response

- KibanaHTTPAPIsInstallPackageResponse
  - `_meta` object, required
    - `install_source` string, required
    - `name` string, required
  - `items` union[], required
    - union
      - KibanaHTTPAPIsKibanaAssetReference
        - `deferred` boolean
        - `id` string, required
        - `originId` string
        - `type` union, required
          - 'dashboard' | 'lens' | 'visualization' | 'search' | 'index-pattern' | 'map' | 'ml-module' | 'security-rule' | 'csp-rule-template' | 'osquery-pack-asset' | 'osquery-saved-query' | 'tag'
          - string
      - KibanaHTTPAPIsEsAssetReference
        - `customDataStreamOriginDataset` string
        - `customDataStreamOriginType` string
        - `deferred` boolean
        - `id` string, required
        - `type` 'index' | 'index_template' | 'component_template' | 'ingest_pipeline' | 'ilm_policy' | 'data_stream_ilm_policy' | 'transform' | 'ml_model' | 'knowledge_base' | 'esql_view', required
        - `version` string

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/elastic/apis/kibana-apis.md) · [All operations](https://skmtc.net/elastic/apis/kibana-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elastic/kibana-apis/versions/531c9e2a7d23/schema)