---
title: "Create Connection"
method: POST
path: "/v1/teams/{team_id}/connections"
tags: ["operator"]
---

# Create Connection

`POST /v1/teams/{team_id}/connections`

## Path parameters

- `team_id` string, uuid, required

## Headers

- `authorization` string, nullable
- `x-darwin-token` string, nullable

## Request body

- CreateConnectionRequest
  - `kind` 'phone' | 'email' | 'telegram' | 'web', required
  - `provider` string, required
  - `external_account_id` string, required
  - `display_name` string, required
  - `status` 'connected' | 'degraded' | 'disconnected' | 'revoked'
  - `secret_ref` string, nullable
  - `capabilities` string[]
  - `config` object

## Response `201`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/stormy/apis/stormy-control-plane.md) · [All operations](https://skmtc.dev/stormy/apis/stormy-control-plane/llms.txt) · [OpenAPI document](https://skmtc.dev/stormy/apis/stormy-control-plane/revisions/b09e3c4ee2af?raw)