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

# Create Connection

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

## Request

- Base URL: `https://api.myaltimate.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.myaltimate.com/api/v1/dbt/cloud/connections`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

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.dev/myaltimate/apis/myaltimate-api.md) - [All operations](https://skmtc.dev/myaltimate/apis/myaltimate-api/llms.txt) - [OpenAPI document](https://skmtc.dev/myaltimate/apis/myaltimate-api/revisions/727657ce54e9?raw)