---
title: "Create output"
method: POST
path: "/api/fleet/outputs"
tags: ["Fleet outputs"]
---

# Create output

`POST /api/fleet/outputs`

**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/outputs</span></div>

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

Create a new Fleet output.<br/><br/>[Required authorization] Route required privileges: fleet-settings-all.

## Headers

- `kbn-xsrf` string, required

## Request body

- union
  - KibanaHTTPAPIsNewOutputElasticsearch
    - `allow_edit` string[]
    - `ca_sha256` string, nullable
    - `ca_trusted_fingerprint` string, nullable
    - `config_yaml` string, nullable
    - `hosts` string[], required
    - `id` string
    - `is_default` boolean
    - `is_default_monitoring` boolean
    - `is_internal` boolean
    - `is_preconfigured` boolean
    - `name` string, required
    - `otel_disable_beatsauth` boolean, nullable
    - `otel_exporter_config_yaml` string, nullable
    - `preset` 'balanced' | 'custom' | 'throughput' | 'scale' | 'latency'
    - `proxy_id` string, nullable
    - `secrets` object
      - `ssl` object
        - `key` union
          - object
            - `hash` string
            - `id` string, required
          - string
    - `shipper` KibanaHTTPAPIsOutputShipper
      - `compression_level` number, nullable
      - `disk_queue_compression_enabled` boolean, nullable
      - `disk_queue_enabled` boolean, nullable
      - `disk_queue_encryption_enabled` boolean, nullable
      - `disk_queue_max_size` number, nullable
      - `disk_queue_path` string, nullable
      - `loadbalance` boolean, nullable
      - `max_batch_bytes` number, nullable
      - `mem_queue_events` number, nullable
      - `queue_flush_timeout` number, nullable
    - `ssl` KibanaHTTPAPIsOutputSsl
      - `certificate` string
      - `certificate_authorities` string[]
      - `key` string
      - `verification_mode` 'full' | 'none' | 'certificate' | 'strict'
    - `type` 'elasticsearch', required
    - `write_to_logs_streams` boolean, nullable
  - KibanaHTTPAPIsNewOutputRemoteElasticsearch
    - `allow_edit` string[]
    - `ca_sha256` string, nullable
    - `ca_trusted_fingerprint` string, nullable
    - `config_yaml` string, nullable
    - `hosts` string[], required
    - `id` string
    - `is_default` boolean
    - `is_default_monitoring` boolean
    - `is_internal` boolean
    - `is_preconfigured` boolean
    - `kibana_api_key` string, nullable
    - `kibana_url` string, nullable
    - `name` string, required
    - `otel_disable_beatsauth` boolean, nullable
    - `otel_exporter_config_yaml` string, nullable
    - `preset` 'balanced' | 'custom' | 'throughput' | 'scale' | 'latency'
    - `proxy_id` string, nullable
    - `secrets` object
      - `service_token` union
        - object
          - `hash` string
          - `id` string, required
        - string
      - `ssl` object
        - `key` union
          - object
            - `hash` string
            - `id` string, required
          - string
    - `service_token` string, nullable
    - `shipper` KibanaHTTPAPIsOutputShipper
      - `compression_level` number, nullable
      - `disk_queue_compression_enabled` boolean, nullable
      - `disk_queue_enabled` boolean, nullable
      - `disk_queue_encryption_enabled` boolean, nullable
      - `disk_queue_max_size` number, nullable
      - `disk_queue_path` string, nullable
      - `loadbalance` boolean, nullable
      - `max_batch_bytes` number, nullable
      - `mem_queue_events` number, nullable
      - `queue_flush_timeout` number, nullable
    - `ssl` KibanaHTTPAPIsOutputSsl
      - `certificate` string
      - `certificate_authorities` string[]
      - `key` string
      - `verification_mode` 'full' | 'none' | 'certificate' | 'strict'
    - `sync_integrations` boolean
    - `sync_uninstalled_integrations` boolean
    - `type` 'remote_elasticsearch', required
    - `write_to_logs_streams` boolean, nullable
  - KibanaHTTPAPIsNewOutputLogstash
    - `allow_edit` string[]
    - `ca_sha256` string, nullable
    - `ca_trusted_fingerprint` string, nullable
    - `config_yaml` string, nullable
    - `hosts` string[], required
    - `id` string
    - `is_default` boolean
    - `is_default_monitoring` boolean
    - `is_internal` boolean
    - `is_preconfigured` boolean
    - `name` string, required
    - `otel_disable_beatsauth` boolean, nullable
    - `otel_exporter_config_yaml` string, nullable
    - `proxy_id` string, nullable
    - `secrets` object
      - `ssl` object
        - `key` union
          - object
            - `hash` string
            - `id` string, required
          - string
    - `shipper` KibanaHTTPAPIsOutputShipper
      - `compression_level` number, nullable
      - `disk_queue_compression_enabled` boolean, nullable
      - `disk_queue_enabled` boolean, nullable
      - `disk_queue_encryption_enabled` boolean, nullable
      - `disk_queue_max_size` number, nullable
      - `disk_queue_path` string, nullable
      - `loadbalance` boolean, nullable
      - `max_batch_bytes` number, nullable
      - `mem_queue_events` number, nullable
      - `queue_flush_timeout` number, nullable
    - `ssl` KibanaHTTPAPIsOutputSsl
      - `certificate` string
      - `certificate_authorities` string[]
      - `key` string
      - `verification_mode` 'full' | 'none' | 'certificate' | 'strict'
    - `type` 'logstash', required
  - KibanaHTTPAPIsNewOutputKafka
    - `allow_edit` string[]
    - `auth_type` 'none' | 'user_pass' | 'ssl' | 'kerberos', required
    - `broker_timeout` number
    - `ca_sha256` string, nullable
    - `ca_trusted_fingerprint` string, nullable
    - `client_id` string
    - `compression` 'gzip' | 'snappy' | 'lz4' | 'none'
    - `compression_level` number, nullable
    - `config_yaml` string, nullable
    - `connection_type` 'plaintext' | 'encryption'
    - `hash` object
      - `hash` string
      - `random` boolean
    - `headers` object[]
      - `key` string, required
      - `value` string, required
    - `hosts` string[], required
    - `id` string
    - `is_default` boolean
    - `is_default_monitoring` boolean
    - `is_internal` boolean
    - `is_preconfigured` boolean
    - `key` string
    - `name` string, required
    - `otel_disable_beatsauth` boolean, nullable
    - `otel_exporter_config_yaml` string, nullable
    - `partition` 'random' | 'round_robin' | 'hash'
    - `password` string, nullable
    - `proxy_id` string, nullable — Kafka outputs do not support proxy configuration. This field is accepted for backwards compatibility but is ignored — it is cleared to null on save and has no effect on the compiled agent policy.
    - `random` object
      - `group_events` number
    - `required_acks` 1 | 0 | -1
    - `round_robin` object
      - `group_events` number
    - `sasl` object, nullable
      - `mechanism` 'PLAIN' | 'SCRAM-SHA-256' | 'SCRAM-SHA-512'
    - `secrets` object
      - `password` union
        - object
          - `hash` string
          - `id` string, required
        - string
      - `ssl` object
        - `key` union, required
          - object
            - `hash` string
            - `id` string, required
          - string
    - `shipper` KibanaHTTPAPIsOutputShipper
      - `compression_level` number, nullable
      - `disk_queue_compression_enabled` boolean, nullable
      - `disk_queue_enabled` boolean, nullable
      - `disk_queue_encryption_enabled` boolean, nullable
      - `disk_queue_max_size` number, nullable
      - `disk_queue_path` string, nullable
      - `loadbalance` boolean, nullable
      - `max_batch_bytes` number, nullable
      - `mem_queue_events` number, nullable
      - `queue_flush_timeout` number, nullable
    - `ssl` KibanaHTTPAPIsOutputSsl
      - `certificate` string
      - `certificate_authorities` string[]
      - `key` string
      - `verification_mode` 'full' | 'none' | 'certificate' | 'strict'
    - `timeout` number
    - `topic` string
    - `type` 'kafka', required
    - `username` string, nullable
    - `version` string

## Response `200`

Successful response

- object
  - `item` union, required
    - KibanaHTTPAPIsOutputResponseElasticsearch
      - `allow_edit` string[]
      - `ca_sha256` string, nullable
      - `ca_trusted_fingerprint` string, nullable
      - `config_yaml` string, nullable
      - `hosts` string[], required
      - `id` string
      - `is_default` boolean
      - `is_default_monitoring` boolean
      - `is_internal` boolean
      - `is_preconfigured` boolean
      - `name` string, required
      - `otel_disable_beatsauth` boolean, nullable
      - `otel_exporter_config_yaml` string, nullable
      - `preset` 'balanced' | 'custom' | 'throughput' | 'scale' | 'latency'
      - `proxy_id` string, nullable
      - `secrets` object
        - `ssl` object
          - `key` union
            - object
              - …
            - string
      - `shipper` KibanaHTTPAPIsOutputResponseShipper
        - `compression_level` number, nullable
        - `disk_queue_compression_enabled` boolean, nullable
        - `disk_queue_enabled` boolean, nullable
        - `disk_queue_encryption_enabled` boolean, nullable
        - `disk_queue_max_size` number, nullable
        - `disk_queue_path` string, nullable
        - `loadbalance` boolean, nullable
        - `max_batch_bytes` number, nullable
        - `mem_queue_events` number, nullable
        - `queue_flush_timeout` number, nullable
      - `ssl` KibanaHTTPAPIsOutputResponseSsl
        - `certificate` string
        - `certificate_authorities` string[]
        - `key` string
        - `verification_mode` 'full' | 'none' | 'certificate' | 'strict'
      - `type` 'elasticsearch', required
      - `write_to_logs_streams` boolean, nullable
    - KibanaHTTPAPIsOutputResponseRemoteElasticsearch
      - `allow_edit` string[]
      - `ca_sha256` string, nullable
      - `ca_trusted_fingerprint` string, nullable
      - `config_yaml` string, nullable
      - `hosts` string[], required
      - `id` string
      - `is_default` boolean
      - `is_default_monitoring` boolean
      - `is_internal` boolean
      - `is_preconfigured` boolean
      - `kibana_api_key` string, nullable
      - `kibana_url` string, nullable
      - `name` string, required
      - `otel_disable_beatsauth` boolean, nullable
      - `otel_exporter_config_yaml` string, nullable
      - `preset` 'balanced' | 'custom' | 'throughput' | 'scale' | 'latency'
      - `proxy_id` string, nullable
      - `secrets` object
        - `service_token` union
          - object
            - `hash` string
            - `id` string, required
          - string
        - `ssl` object
          - `key` union
            - object
              - …
            - string
      - `service_token` string, nullable
      - `shipper` KibanaHTTPAPIsOutputResponseShipper
        - `compression_level` number, nullable
        - `disk_queue_compression_enabled` boolean, nullable
        - `disk_queue_enabled` boolean, nullable
        - `disk_queue_encryption_enabled` boolean, nullable
        - `disk_queue_max_size` number, nullable
        - `disk_queue_path` string, nullable
        - `loadbalance` boolean, nullable
        - `max_batch_bytes` number, nullable
        - `mem_queue_events` number, nullable
        - `queue_flush_timeout` number, nullable
      - `ssl` KibanaHTTPAPIsOutputResponseSsl
        - `certificate` string
        - `certificate_authorities` string[]
        - `key` string
        - `verification_mode` 'full' | 'none' | 'certificate' | 'strict'
      - `sync_integrations` boolean
      - `sync_uninstalled_integrations` boolean
      - `type` 'remote_elasticsearch', required
      - `write_to_logs_streams` boolean, nullable
    - KibanaHTTPAPIsOutputResponseLogstash
      - `allow_edit` string[]
      - `ca_sha256` string, nullable
      - `ca_trusted_fingerprint` string, nullable
      - `config_yaml` string, nullable
      - `hosts` string[], required
      - `id` string
      - `is_default` boolean
      - `is_default_monitoring` boolean
      - `is_internal` boolean
      - `is_preconfigured` boolean
      - `name` string, required
      - `otel_disable_beatsauth` boolean, nullable
      - `otel_exporter_config_yaml` string, nullable
      - `proxy_id` string, nullable
      - `secrets` object
        - `ssl` object
          - `key` union
            - object
              - …
            - string
      - `shipper` KibanaHTTPAPIsOutputResponseShipper
        - `compression_level` number, nullable
        - `disk_queue_compression_enabled` boolean, nullable
        - `disk_queue_enabled` boolean, nullable
        - `disk_queue_encryption_enabled` boolean, nullable
        - `disk_queue_max_size` number, nullable
        - `disk_queue_path` string, nullable
        - `loadbalance` boolean, nullable
        - `max_batch_bytes` number, nullable
        - `mem_queue_events` number, nullable
        - `queue_flush_timeout` number, nullable
      - `ssl` KibanaHTTPAPIsOutputResponseSsl
        - `certificate` string
        - `certificate_authorities` string[]
        - `key` string
        - `verification_mode` 'full' | 'none' | 'certificate' | 'strict'
      - `type` 'logstash', required
    - KibanaHTTPAPIsOutputResponseKafka
      - `allow_edit` string[]
      - `auth_type` 'none' | 'user_pass' | 'ssl' | 'kerberos', required
      - `broker_timeout` number
      - `ca_sha256` string, nullable
      - `ca_trusted_fingerprint` string, nullable
      - `client_id` string
      - `compression` 'gzip' | 'snappy' | 'lz4' | 'none'
      - `compression_level` number, nullable
      - `config_yaml` string, nullable
      - `connection_type` 'plaintext' | 'encryption'
      - `hash` object
        - `hash` string
        - `random` boolean
      - `headers` object[]
        - `key` string, required
        - `value` string, required
      - `hosts` string[], required
      - `id` string
      - `is_default` boolean
      - `is_default_monitoring` boolean
      - `is_internal` boolean
      - `is_preconfigured` boolean
      - `key` string
      - `name` string, required
      - `otel_disable_beatsauth` boolean, nullable
      - `otel_exporter_config_yaml` string, nullable
      - `partition` 'random' | 'round_robin' | 'hash'
      - `password` string, nullable
      - `proxy_id` string, nullable — Kafka outputs do not support proxy configuration. This field is accepted for backwards compatibility but is ignored — it is cleared to null on save and has no effect on the compiled agent policy.
      - `random` object
        - `group_events` number
      - `required_acks` 1 | 0 | -1
      - `round_robin` object
        - `group_events` number
      - `sasl` object, nullable
        - `mechanism` 'PLAIN' | 'SCRAM-SHA-256' | 'SCRAM-SHA-512'
      - `secrets` object
        - `password` union
          - object
            - `hash` string
            - `id` string, required
          - string
        - `ssl` object
          - `key` union, required
            - object
              - …
            - string
      - `shipper` KibanaHTTPAPIsOutputResponseShipper
        - `compression_level` number, nullable
        - `disk_queue_compression_enabled` boolean, nullable
        - `disk_queue_enabled` boolean, nullable
        - `disk_queue_encryption_enabled` boolean, nullable
        - `disk_queue_max_size` number, nullable
        - `disk_queue_path` string, nullable
        - `loadbalance` boolean, nullable
        - `max_batch_bytes` number, nullable
        - `mem_queue_events` number, nullable
        - `queue_flush_timeout` number, nullable
      - `ssl` KibanaHTTPAPIsOutputResponseSsl
        - `certificate` string
        - `certificate_authorities` string[]
        - `key` string
        - `verification_mode` 'full' | 'none' | 'certificate' | 'strict'
      - `timeout` number
      - `topic` string
      - `type` 'kafka', required
      - `username` string, nullable
      - `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)