---
title: "Create Auth Config Endpoint"
method: POST
path: "/api/integration-auth-configs/"
tags: ["integration-auth-configs", "integration-auth-configs"]
---

# Create Auth Config Endpoint

`POST /api/integration-auth-configs/`

## 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/integration-auth-configs/`
- Auth: none declared

Create an auth config.

POST /api/integration-auth-configs
{
  "provider": "google",
  "management": "managed",
  "auth_scheme": "oauth2",
  "scopes": ["https://www.googleapis.com/auth/gmail.readonly"],
  "name": "My Google Config",
  "custom_client": null  # required only if management='custom'
}

Returns 201 with {"id": <new_id>}.
Returns 422 if managed scope not verified.
Returns 400 if custom without custom_client or invalid status.

## Request body

- AuthConfigCreate: Create an auth config (managed or custom).
  - `provider` string, required
  - `management` string, required
  - `auth_scheme` string, required
  - `scopes` string[]
  - `name` string, required
  - `custom_client` object, nullable

## Response `201`

Successful Response

- object

## 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)