---
title: "Create connection"
method: POST
path: "/workspace/{ws_id}/connections"
tags: ["Connections"]
---

# Create connection

`POST /workspace/{ws_id}/connections`

Creates a new Connection

## Path parameters

- `ws_id` string, required

## Request body

- ApiDocsCreateConnectionRequest
  - `attributes` object
  - `connection_type_id` string
  - `created_with_o_auth` boolean
  - `creation_method` string
  - `name` string

## Response `200`

ok

- ModelsConnection
  - `attributes` ModelsConnectionAttributes
  - `connection_type_id` string
  - `created_at` integer
  - `created_by` string
  - `created_with_o_auth` boolean
  - `creation_location` string
  - `creation_method` string
  - `description` string
  - `display_name` string
  - `external_id` string — ExternalId mapping to external entity identifier associated with this connection (used on revoke/uninstall events e.g.)
  - `full_name` string
  - `id` string
  - `name` string — Connection names are unique per tenant as they are used in playbook YAML
  - `secret_manager` string
  - `status` string
  - `tenant_id` string
  - `updated_at` integer
  - `updated_by` string
  - `workspace_id` string

## Other responses

- `400` — Cannot create Connection

---

[API](https://skmtc.net/blinkops/apis/blink-rest-api.md) · [All operations](https://skmtc.net/blinkops/apis/blink-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blinkops/blink-rest-api/revisions/f043409736b2/schema)