---
title: "Create an external connection (role: admin+)"
method: POST
path: "/api/connections"
tags: ["Connections"]
---

# Create an external connection (role: admin+)

`POST /api/connections`

## Request

- Base URL: `https://api.witwiki.app`
- URL: `https://api.witwiki.app/api/connections`
- Auth: HTTP bearer

## Request body

- object
  - `provider` 'linear' | 'notion' | 'slack' | 'granola'
  - `token` string: Stored KMS-encrypted; never returned

## Response `201`

Created

---

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