---
title: "Create a connector"
method: POST
path: "/connectors"
tags: ["Connectors"]
---

# Create a connector

`POST /connectors`

## Request

- Base URL: `https://commareports.com/api/v1`
- URL: `https://commareports.com/api/v1/connectors`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

The `secret` object (keyed per the kind's definition, e.g. `{ "token": "…" }`) is encrypted at rest and never returned by any endpoint. 409 on a duplicate kind + label. Also accepts a Supabase user-session JWT. Scope: `connections`.

## Request body

- ConnectorCreateRequest
  - `kind` string, required: Must be a catalog kind (see GET /connectors → definitions).
  - `label` string, required
  - `config` object: Fields per the kind's configSchema.
  - `secret` object: Fields per the kind's secretSchema, e.g. { "token": "…" }. Encrypted at rest; never returned.

## Response `201`

Connector created.

- Connector: Secret material is never included in any response.
  - `id` string, uuid, required
  - `kind` string, required: One of the catalog kinds, e.g. posthog, databricks, supabase, gdrive, stripe, slack.
  - `label` string, required
  - `config` object: Non-secret configuration (hosts, urls, labels).
  - `last_verified_at` string, date-time, nullable
  - `last_verified_status` 'ok' | 'failed' | 'null', nullable
  - `last_verified_error` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `400`: Malformed body or invalid field.
- `401`: Missing, invalid, revoked, or expired token.
- `403`: Token missing the required scope, or no access to the resource.
- `409`: A connector with this kind + label already exists.
- `429`: Rate limit exceeded. Rate limit: per-token sliding window (plan-aware — Free 60 req/min, Pro 600, Team/Enterprise 6000 by default); 429 responses carry a Retry-After header.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/commareports/apis/comma-api.md) · [All operations](https://skmtc.dev/commareports/apis/comma-api/llms.txt) · [OpenAPI document](https://skmtc.dev/commareports/apis/comma-api/revisions/cd5263522ade?raw)