---
title: "Create Integration"
method: POST
path: "/api/workspace-integrations"
tags: ["workspace-integrations", "workspace-integrations"]
---

# Create Integration

`POST /api/workspace-integrations`

## Request

- Base URL: `https://api.dialogbrain.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dialogbrain.com/api/workspace-integrations`
- Auth: none declared

Create + dispatch the three sub-cases on initial catalog refresh.

a. Static bearer / API key  → sync tools/list; failure = 502 + no row
b. OAuth pre-authorised     → status='auth_required'; skip refresh
c. OAuth auto-discovery     → sync tools/list expecting 401 +
                              WWW-Authenticate; persist auth_required
                              + oauth_metadata; any other response
                              = 502 + no row

## Request body

- IntegrationCreate
  - `integration_type` string, required
  - `provider` string, required
  - `transport` string
  - `config` object
  - `auth_config_id` integer, nullable

## Response `201`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway.md) · [All operations](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/revisions/77bef09a9209?raw)