---
title: "Create a new service integration"
method: POST
path: "/project/{project}/integration"
tags: ["Service_Integrations"]
---

# Create a new service integration

`POST /project/{project}/integration`

## Path parameters

- `project` string, required

## Request body

- ServiceIntegrationCreateRequestBody — ServiceIntegrationCreateRequestBody
  - `dest_endpoint_id` string — Integration destination endpoint ID
  - `dest_project` string — Defaults to project in the request path
  - `dest_service` string — Destination service name
  - `integration_type` 'alertmanager' | 'application_service_credential' | 'autoscaler' | 'autoscaler_service' | 'caching' | 'clickhouse_credentials' | 'clickhouse_kafka' | 'clickhouse_postgresql' | 'dashboard' | 'datadog' | 'datahub_metadata_ingestion' | 'datasource' | 'disaster_recovery' | 'external_aws_cloudwatch_logs' | 'external_aws_cloudwatch_metrics' | 'external_elasticsearch_logs' | 'external_google_cloud_logging' | 'external_opensearch_logs' | 'flink' | 'flink_external_bigquery' | 'flink_external_kafka' | 'flink_external_postgresql' | 'internal_connectivity' | 'jolokia' | 'kafka_connect' | 'kafka_connect_postgresql' | 'kafka_inkless_postgresql' | 'kafka_logs' | 'kafka_mirrormaker' | 'logs' | 'metrics' | 'opensearch_cross_cluster_replication' | 'opensearch_cross_cluster_search' | 'opentelemetry' | 'prometheus' | 'read_replica' | 'rsyslog' | 'schema_registry_proxy' | 'service_composition' | 'stresstester' | 'thanos_distributed_query' | 'thanos_migrate' | 'thanos_object_storage' | 'thanoscompactor' | 'thanosquery' | 'thanosruler' | 'thanosstore' | 'vector' | 'vmalert', required — Service integration type
  - `source_endpoint_id` string — Integration source endpoint ID
  - `source_project` string — Defaults to project in the request path
  - `source_service` string — Source service name
  - `user_config` object — Service type-specific settings

## Response `200`

Response

- ServiceIntegrationCreateResponse — ServiceIntegrationCreateResponse
  - `errors` object[] — List of errors occurred during request processing
    - `message` string, required — Printable error message
    - `more_info` string — URL to the documentation of the error
    - `status` integer, required — HTTP error status code
  - `message` string — Printable result of the request
  - `service_integration` object, required — Service integration
    - `active` boolean, required — True when integration is active
    - `description` string, required — Description of the integration
    - `dest_endpoint` string — Destination endpoint name
    - `dest_endpoint_id` string — Destination endpoint id
    - `dest_project` string, required — Project name
    - `dest_service` string — Destination service name
    - `dest_service_type` string, required — Service type code
    - `enabled` boolean, required — True when integration is enabled
    - `integration_status` object — Integration status
      - `state` object, required — Service integration state
        - `errors` string[], required — Errors
        - `likely_error_cause` 'null' | 'destination' | 'integration' | 'source' | 'unknown' — Most likely cause of the errors
        - `nodes` object, required — Nodes
        - `status` 'failed' | 'inactive' | 'running' | 'starting' | 'unknown', required — Service integration status
      - `status_user_desc` string, required — Integration status description
    - `integration_type` string, required — Type of the integration
    - `service_integration_id` string, required — Integration ID
    - `source_endpoint` string — Source endpoint name
    - `source_endpoint_id` string — Source endpoint ID
    - `source_project` string, required — Project name
    - `source_service` string, required — Source service name
    - `source_service_type` string, required — Service type code
    - `user_config` object — Service integration settings

---

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