---
title: "Create Connection"
method: POST
path: "/api/v1/dbt/cloud/connections"
tags: ["DBT_CLOUD", "dbt_cloud"]
---

# Create Connection

`POST /api/v1/dbt/cloud/connections`

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

## Request body

- DbtCloudConnectionCreateRequest — Request to create a new dbt Cloud connection.
  - `name` string, required — Connection name
  - `api_token` string, required — dbt Cloud service token
  - `account_id` string, required — dbt Cloud account ID
  - `api_base_url` string, nullable — API base URL (for single-tenant or regional deployments)
  - `sync_type` string, nullable — Sync type: 'scheduled' or 'real_time'
  - `schedule_cron` string, nullable — Cron expression for sync schedule (only used when sync_type is 'scheduled')
  - `lookback_days` integer, nullable — Days to look back for runs

## Response `201`

Successful Response

- DbtCloudConnectionResponse — dbt Cloud connection information.
  - `id` integer, required
  - `name` string, required
  - `account_id` string, required
  - `api_base_url` string, required
  - `is_active` boolean, required
  - `created_at` string, date-time, required
  - `last_modified_at` string, date-time, required
  - `created_by` integer, required
  - `last_modified_by` integer, required
  - `projects` DbtCloudProjectResponse[], nullable
    - `id` integer, required
    - `external_project_id` string, required
    - `project_name` string, nullable, required
    - `dbt_core_integration_id` integer, required
    - `is_enabled` boolean, required
    - `created_at` string, date-time, required
    - `last_modified_at` string, date-time, required
    - `environments` DbtCloudEnvironmentResponse[], nullable
      - `id` integer, required
      - `external_environment_id` string, required
      - `environment_name` string, nullable, required
      - `environment_type` string, nullable, required
      - `dbt_core_integration_environment_id` integer, required
      - `is_enabled` boolean, required
      - `last_processed_run_finished_at` string, date-time, nullable, required
      - `created_at` string, date-time, required
      - `last_modified_at` string, date-time, required
      - `processed_runs_count` integer, nullable
  - `schedule` DbtCloudScheduleResponse — Sync schedule configuration.
    - `id` integer, required
    - `sync_type` string, required
    - `cron_expr` string, required
    - `lookback_days` integer, required
    - `is_active` boolean, required
    - `last_sync_at` string, date-time, nullable
    - `last_sync_status` string, nullable
    - `last_sync_error` string, nullable
    - `created_at` string, date-time, required
    - `last_modified_at` string, date-time, required

## Other responses

- `400` — Bad request
- `403` — Forbidden
- `404` — Not found
- `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/aab3fe5c9f05/schema)