---
title: "Create a Connect Cluster"
method: POST
path: "/usm/v1/connect-clusters"
tags: ["Connect Clusters (usm/v1)"]
---

# Create a Connect Cluster

`POST /usm/v1/connect-clusters`

[![Preview](https://img.shields.io/badge/Lifecycle%20Stage-Preview-%2300afba)](#section/Versioning/API-Lifecycle-Policy)

Make a request to create a connect cluster.

## Request body

- object — `ConnectCluster` object represent Confluent Platform Connect clusters registered with Confluent Cloud. The API allows you to create and delete ConnectCluster. ## The Connect Clusters Model <SchemaDefinition schemaRef="#/components/schemas/usm.v1.ConnectCluster" />
  - `api_version` 'usm/v1' — APIVersion defines the schema version of this representation of a resource.
  - `kind` 'ConnectCluster' — Kind defines the object this REST resource represents.
  - `id` string — ID is the "natural identifier" for an object within its scope/namespace; it is normally unique across time but not space. That is, you can assume that the ID will not be reclaimed and reused after an object is deleted ("time"); however, it may collide with IDs for other object `kinds` or objects of the same `kind` within a different scope/namespace ("space").
  - `confluent_platform_connect_cluster_id` string, required — The unique identifier of the Connect cluster within the Confluent Platform environment.
  - `kafka_cluster_id` string, required — The unique identifier of the metadata Kafka cluster for the Connect Cluster.
  - `usm_kafka_cluster_id` string — The unique identifier of the metadata Kafka cluster for the Connect Cluster.
  - `cloud` string — The cloud service provider where the metadata for the Connect Cluster should be stored. This field is optional. If provided, 'region' must also be provided. If neither 'cloud' nor 'region' are provided, the cloud provider of the associated metadata Kafka cluster (identified by 'kafka_cluster_id') will be used as a fallback.
  - `region` string — The home region of the Confluent Platform Connect cluster where the metadata should be stored. This field is optional. If provided, 'cloud' must also be provided. If neither 'cloud' nor 'region' are provided, the home region of the associated metadata Kafka cluster (identified by 'kafka_cluster_id') will be used as a fallback.
  - `environment` object, required — The environment to which this belongs.
    - `id` string, required — ID of the referred resource
    - `environment` string — Environment of the referred resource, if env-scoped
    - `related` string, uri, required — API URL for accessing or modifying the referred object
    - `resource_name` string, uri, required — CRN reference to the referred resource

## Response `201`

A Connect Cluster was created.

- object — `ConnectCluster` object represent Confluent Platform Connect clusters registered with Confluent Cloud. The API allows you to create and delete ConnectCluster. ## The Connect Clusters Model <SchemaDefinition schemaRef="#/components/schemas/usm.v1.ConnectCluster" />
  - `api_version` 'usm/v1' — APIVersion defines the schema version of this representation of a resource.
  - `kind` 'ConnectCluster' — Kind defines the object this REST resource represents.
  - `id` string — ID is the "natural identifier" for an object within its scope/namespace; it is normally unique across time but not space. That is, you can assume that the ID will not be reclaimed and reused after an object is deleted ("time"); however, it may collide with IDs for other object `kinds` or objects of the same `kind` within a different scope/namespace ("space").
  - `confluent_platform_connect_cluster_id` string, required — The unique identifier of the Connect cluster within the Confluent Platform environment.
  - `kafka_cluster_id` string, required — The unique identifier of the metadata Kafka cluster for the Connect Cluster.
  - `usm_kafka_cluster_id` string — The unique identifier of the metadata Kafka cluster for the Connect Cluster.
  - `cloud` string — The cloud service provider where the metadata for the Connect Cluster should be stored. This field is optional. If provided, 'region' must also be provided. If neither 'cloud' nor 'region' are provided, the cloud provider of the associated metadata Kafka cluster (identified by 'kafka_cluster_id') will be used as a fallback.
  - `region` string — The home region of the Confluent Platform Connect cluster where the metadata should be stored. This field is optional. If provided, 'cloud' must also be provided. If neither 'cloud' nor 'region' are provided, the home region of the associated metadata Kafka cluster (identified by 'kafka_cluster_id') will be used as a fallback.
  - `environment` object, required — The environment to which this belongs.
    - `id` string, required — ID of the referred resource
    - `environment` string — Environment of the referred resource, if env-scoped
    - `related` string, uri, required — API URL for accessing or modifying the referred object
    - `resource_name` string, uri, required — CRN reference to the referred resource

## Other responses

- `400` — Bad Request
- `401` — The request lacks valid authentication credentials for this resource.
- `403` — The access credentials were considered insufficient to grant access
- `409` — The request is in conflict with the current server state
- `422` — Validation Failed
- `429` — Rate Limit Exceeded
- `500` — Oops, something went wrong!

---

[API](https://skmtc.dev/confluent/apis/confluent-cloud-apis.md) · [All operations](https://skmtc.dev/confluent/apis/confluent-cloud-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/confluent/confluent-cloud-apis/revisions/a6a73f98a698/schema)