---
title: "Connections Create"
method: POST
path: "/connections"
---

# Connections Create

`POST /connections`

## Request

- Base URL: `https://www.clipzyn.com/v1`
- URL: `https://www.clipzyn.com/v1/connections`
- Auth: HTTP bearer

Create a connection. RSS carries its feed url and activates immediately; an
OAuth provider creates a PENDING connection and returns the authorize URL +
signed state the caller redirects the owner to.

Optional person_id attaches the connection to one of your people. An unknown or foreign person_id is validation_error; the dark
surface is not_found. Fix the body before retrying. Requires the explicitly minted `bernayser:write` scope; bernayser:read permits safe projections and bernayser:write permits mutations. This BERNAYSER operation is quota-neutral. While dark it returns not_found, and a valid key without the required scope receives scope_missing. Fix a non-retryable request or credential before retrying; for rate_limited or service_unavailable, wait for retry_after_sec and retry once.

## Request body

- ConnectionCreateRequest
  - `provider` string, required
  - `display_name` string, required
  - `feed_url` string, nullable
  - `person_id` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

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