---
title: "Create a connection"
method: POST
path: "/admin/connections"
tags: ["admin"]
---

# Create a connection

`POST /admin/connections`

Creates a metadata-only Connection for a tenant. Credentials are set afterwards.

## Request body

- CreateConnectionRequest
  - `display_name` string
  - `provider_id` string

## Response `201`

connection is a single connection response.

- Connection — Wraps Connection with the provider snippet (so tenant UIs don't have to re-resolve the catalog) and the extracted identity at the top level.
  - `auth_method` string
  - `created_at` string, date-time
  - `display_name` string
  - `id` string, uuid
  - `identity` object
  - `metadata` object
  - `provider` ProviderView
    - `display_name` string
    - `id` string
    - `logo_url` string
  - `status` string
  - `tenant_id` string, uuid
  - `updated_at` string, date-time

## Other responses

- `400` — errorGeneric wraps the error model as a response.
- `500` — errorGeneric wraps the error model as a response.

---

[API](https://skmtc.net/hintoric/apis/contains-the-generated-openapi-specification-for-hekate.md) · [All operations](https://skmtc.net/hintoric/apis/contains-the-generated-openapi-specification-for-hekate/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hintoric/contains-the-generated-openapi-specification-for-hekate/revisions/72bd83b55019/schema)