# Create a connection ```http 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 ```bash 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.yaml), [openapi.json](/openapi.json).