v5

latestOpenAPI 3.1.02026-08-081,0211,3082.1 MB
DBT_CLOUD
dbt_cloud

Create Connection

Create a new dbt Cloud connection.

This will:

  1. Validate the API token
  2. Create the connection record
  3. Discover all projects and environments
  4. Create DBTCoreIntegration records for each project
post/api/v1/dbt/cloud/connections

Request body

namestring required

Connection name

api_tokenstring required

dbt Cloud service token

account_idstring required

dbt Cloud account ID

api_base_urlstring nullable

API base URL (for single-tenant or regional deployments)

sync_typestring nullable

Sync type: 'scheduled' or 'real_time'

schedule_cronstring nullable

Cron expression for sync schedule (only used when sync_type is 'scheduled')

lookback_daysinteger nullable

Days to look back for runs

Response

Successful Response

idinteger required
namestring required
account_idstring required
api_base_urlstring required
is_activeboolean required
created_atstring date-time required
last_modified_atstring date-time required
created_byinteger required
last_modified_byinteger required