---
title: "Create a Kafka Connect connector"
method: POST
path: "/project/{project}/service/{service_name}/connectors"
tags: ["Service:_Kafka"]
---

# Create a Kafka Connect connector

`POST /project/{project}/service/{service_name}/connectors`

## Path parameters

- `project` string, required
- `service_name` string, required

## Request body

- ServiceKafkaConnectCreateConnectorRequestBody — ServiceKafkaConnectCreateConnectorRequestBody
  - `connector.class` string, required — The Java class for the connector
  - `name` string, required — Unique name for the connector

## Response `200`

Response

- ServiceKafkaConnectCreateConnectorResponse — ServiceKafkaConnectCreateConnectorResponse
  - `connector` object, required — Kafka connector information
    - `config` object, required — Connector configuration parameters
      - `connector.class` string, required — The Java class for the connector
      - `name` string, required — Unique name for the connector
    - `name` string, required — Connector name
    - `plugin` object, required — Kafka Connector plugin information
      - `author` string, required — Connector author name
      - `available_versions` object[] — Versions available on the service
        - `deprecated` boolean — If the version is deprecated.
        - `needs_maintenance` boolean — Using this version requires a maintenance update.
        - `version` string — Connector version number
      - `class` string, required — Connector class name
      - `docURL` string, required — Connector documentation URL
      - `plugin_name` string — Connector plugin name
      - `preview` boolean — Describes if connector is in beta
      - `preview_info` string — Information about beta stage of connector
      - `title` string, required — Descriptive human readable name defined by Aiven
      - `type` 'sink' | 'source' | 'unknown', required — Describes whether data flows from or to Kafka
      - `version` string, required — Connector version number
    - `tasks` object[], required — List of tasks of a connector
      - `connector` string, required — Related connector name
      - `task` integer, required — Task id / number
  - `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

---

[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)
