Connectors

Create a connector

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.

post/connectors

Request

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

Request body

kindstring required

Must be a catalog kind (see GET /connectors → definitions).

labelstring required
configobject

Fields per the kind's configSchema.

secretobject

Fields per the kind's secretSchema, e.g. { "token": "…" }. Encrypted at rest; never returned.

Response

Connector created.

idstring uuid required
kindstring required

One of the catalog kinds, e.g. posthog, databricks, supabase, gdrive, stripe, slack.

labelstring required
configobject

Non-secret configuration (hosts, urls, labels).

last_verified_atstring date-time nullable
last_verified_status'ok' | 'failed' | 'null' nullable
last_verified_errorstring nullable
created_atstring date-time required
updated_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.