Skip to main content
Databricks uses workspace-level OAuth brokered by Nango. The account-level OAuth flow is a separate, unsupported shape.

​
Prerequisites

  • An account or workspace admin on the Databricks side to register the OAuth app.
  • Your Databricks Account ID and the workspace URL you want to connect.

​
Set up the Databricks OAuth app

Databricks’s own docs are the source of truth here; Nango doesn’t publish a step-by-step guide for this provider. In short:
1

Register a Custom OAuth App in the Databricks account console

From the account console, create a Custom OAuth App Integration. Set the Redirect URL to:
2

Pick scopes

Choose scopes appropriate for the APIs your pipelines will call—typical picks include all-apis, sql, and offline_access. Refer to Databricks’s OAuth docs for the current scope list.
3

Copy the Client ID + Client Secret

Save these for the platform admin.

​
Connect

Open the Databricks setup wizard from Integrations → Databricks. The form asks for two fields, plus the OAuth flow: Click Connect, authorize in Databricks, and you’ll be returned to the app.

​
Gotchas

  • Databricks authenticates at both account and workspace levels. This integration is the workspace flow—<workspace>.cloud.databricks.com access, not cross-workspace admin.
  • Unity Catalog permissions must be granted to the OAuth app user separately. The OAuth grant is the gate to the API; UC grants are the gate to the data.
  • The default crawl cadence is 15 minutes (warehouses are billed per second). Tune per integration with a 5-minute floor.