Create a connection

POST https://api.onehazel.com/onehazel-api/connections

Credentials are encrypted at rest. Identical credentials for the same connector are rejected unless upsert=true.

Section: Connections
Operation id: postConnections

Authentication

Operator API key (oh_live_...) or a signed-in session token, as a bearer token.

Parameters

Name	In	Required	Description
upsert	query	no	Update the existing identical connection instead of returning 409.

Request body

JSON object.

Responses

200 { "success": true, "data": ... }

Errors return { "success": false, "error": { "code": "...", "message": "..." } } with a 4xx or 5xx status.

Example

curl -X POST "https://api.onehazel.com/onehazel-api/connections" \
  -H "Authorization: Bearer oh_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Machine-readable: openapi.yaml, openapi.json.