---
title: "Create Connector"
method: POST
path: "/api/v1/connectors"
tags: ["connectors"]
---

# Create Connector

`POST /api/v1/connectors`

## Request body

- ConnectorCreateRequest
  - `url` string, uri, required
  - `client_id` string, nullable
  - `client_secret` string, nullable
  - `metadata` object, nullable — Set of 16 key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format, and querying for objects via API or the dashboard. Keys are strings with a maximum length of 64 characters. Values are strings with a maximum length of 512 characters.
  - `match_preset` boolean

## Response `201`

Successful Response

- ConnectorResponse
  - `id` string, uuid, required
  - `url` string, uri, required
  - `state` 'created' | 'auth_required' | 'connected' | 'disconnected', required
  - `auth_request` AuthorizationCodeRequest, required
    - `type` 'code'
    - `authorization_endpoint` string, uri, required
  - `disconnect_reason` string, nullable, required
  - `metadata` object, nullable, required — Set of 16 key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format, and querying for objects via API or the dashboard. Keys are strings with a maximum length of 64 characters. Values are strings with a maximum length of 512 characters.
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `created_by` string, uuid, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/kagenti/apis/adk-server.md) · [All operations](https://skmtc.net/kagenti/apis/adk-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kagenti/adk-server/versions/9c0d1a763cc6/schema)