---
title: "Connect Connector"
method: POST
path: "/api/v1/connectors/{connector_id}/connect"
tags: ["connectors"]
---

# Connect Connector

`POST /api/v1/connectors/{connector_id}/connect`

## Path parameters

- `connector_id` string, uuid, required

## Request body

- ConnectorConnectRequest
  - `redirect_url` string, uri, nullable
  - `access_token` string, nullable

## Response `200`

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)