---
title: "Create a connection. The secret is stored encrypted and never returned."
method: POST
path: "/v1/chatbots/connections"
tags: ["ChatbotConnection"]
---

# Create a connection. The secret is stored encrypted and never returned.

`POST /v1/chatbots/connections`

## Request body

- ChatbotConnectionRequest
  - `name` string, required
  - `departmentId` integer
  - `authType` 1 | 2 | 3 — <p>Enum values:</p><ul><li><i>1 = Bearer</i> - Authorization: Bearer <secret></li><li><i>2 = ApiKeyHeader</i> - <HeaderName>: <secret></li><li><i>3 = Basic</i></li></ul>
  - `headerName` string, nullable
  - `secret` string, nullable
  - `baseUrl` string, nullable

## Response `200`

OK

- ChatbotConnectionResponse
  - `id` integer
  - `departmentId` integer
  - `name` string, nullable
  - `authType` 1 | 2 | 3 — <p>Enum values:</p><ul><li><i>1 = Bearer</i> - Authorization: Bearer <secret></li><li><i>2 = ApiKeyHeader</i> - <HeaderName>: <secret></li><li><i>3 = Basic</i></li></ul>
  - `headerName` string, nullable
  - `baseUrl` string, nullable
  - `secretMask` string, nullable
  - `createdDate` string, date-time
  - `updatedDate` string, date-time, nullable

## Other responses

- `422` — Unprocessable Content

---

[API](https://skmtc.dev/infoset/apis/infoset-rest-api.md) · [All operations](https://skmtc.dev/infoset/apis/infoset-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infoset/infoset-rest-api/revisions/f5bc39a1ac15/schema)