---
title: "Create a new Databricks connection"
method: POST
path: "/api/v1/databricks/connections"
tags: ["DATABRICKS", "Databricks", "Databricks Connections"]
deprecated: true
---

# Create a new Databricks connection

`POST /api/v1/databricks/connections`

> **Deprecated.**

## Headers

- `x-tenant` string, required

## Request body

- union
  - DatabricksConnectionCreatePAT
    - `type` string
    - `server_hostname` string, required — Databricks workspace hostname. Must end in cloud.databricks.com, azuredatabricks.net, or gcp.databricks.com.
    - `http_path` string, required — SQL warehouse HTTP path
    - `name` string, required
    - `description` string, nullable
    - `s3_role_arn` string, nullable
    - `s3_external_id` string, nullable
    - `s3_location` string, nullable
    - `auth_type` 'pat'
    - `access_token` string, required
  - DatabricksConnectionCreateOAuthM2M
    - `type` string
    - `server_hostname` string, required — Databricks workspace hostname. Must end in cloud.databricks.com, azuredatabricks.net, or gcp.databricks.com.
    - `http_path` string, required — SQL warehouse HTTP path
    - `name` string, required
    - `description` string, nullable
    - `s3_role_arn` string, nullable
    - `s3_external_id` string, nullable
    - `s3_location` string, nullable
    - `auth_type` 'oauth_m2m', required
    - `client_id` string, required
    - `client_secret` string, required
    - `azure_tenant_id` string, nullable

## Response `201`

Successful Response

- DatabricksConnectionResponse
  - `id` integer, required
  - `name` string, required
  - `description` string, nullable
  - `server_hostname` string, required
  - `http_path` string, required
  - `auth_type` 'pat' | 'oauth_m2m' — Stored auth methods for Databricks connections. Entra-managed service principals are not a separate type — they are ``oauth_m2m`` rows whose ``azure_tenant_id`` lives in ``connection_info``; its presence routes token minting to Microsoft Entra ID instead of the workspace OIDC endpoint.
  - `azure_tenant_id` string, nullable
  - `workspace_id` string, nullable
  - `metastore_id` string, nullable
  - `s3_role_arn` string, nullable
  - `s3_location` string, nullable
  - `is_valid` boolean, required
  - `last_validated_at` string, date-time, nullable
  - `created_at` string, date-time, required
  - `last_modified_at` string, date-time, required
  - `created_by` integer, nullable
  - `last_modified_by` integer, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/myaltimate/apis/fastapi.md) · [All operations](https://skmtc.net/myaltimate/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/myaltimate/fastapi/versions/50769cbf05d5/schema)