DBT Connection

Hanzo KMS supports the use of Personal Access Tokens to connect with DBT.

Create DBT Personal Access Token

On your DBT dashboard, press the organization name in the bottom left corner, and press Account Settings.

DBT Account Settings

Click on the Personal Access Tokens tab and click Create personal access token.

Create Personal Access Token

Enter a descriptive name for the token and click Save.

Enter Token Name

Copy the token from the modal for later steps.

Copy Token

Create DBT Connection in Hanzo KMS

In your Hanzo KMS dashboard, navigate to the App Connections page in the desired project.

App Connections Tab

Click the Add Connection button and select DBT from the list of available connections.

Select DBT Connection

Complete the DBT Connection form by entering:

A descriptive name for the connection
An optional description for future reference
Your DBT instance URL
Your DBT account ID
The Personal Access Token from earlier steps

Connection Modal

After clicking Create, your DBT Connection is established and ready to use with your Hanzo KMS project.

Connection Created

To create a DBT Connection, make an API request to the Create DBT Connection API endpoint.

Sample request

curl    --request POST \
        --url https://app.kms.hanzo.ai/api/v1/app-connections/dbt \
        --header 'Content-Type: application/json' \
        --data '{
            "name": "my-dbt-connection",
            "method": "api-token",
            "projectId": "7ffbb072-2575-495a-b5b0-127f88caef78",
            "credentials": {
                "instanceUrl": "https://example.dbt.com",
                "accountId": "<YOUR-ACCOUNT-ID>",
                "apiToken": "<YOUR-API-TOKEN>"
            }
        }'

Sample response

{
  "appConnection": {
      "id": "e5d18aca-86f7-4026-a95e-efb8aeb0d8e6",
      "name": "my-dbt-connection",
      "projectId": "7ffbb072-2575-495a-b5b0-127f88caef78",
      "description": null,
      "version": 1,
      "orgId": "6f03caa1-a5de-43ce-b127-95a145d3464c",
      "createdAt": "2025-04-23T19:46:34.831Z",
      "updatedAt": "2025-04-23T19:46:34.831Z",
      "isPlatformManagedCredentials": false,
      "credentialsHash": "7c2d371dec195f82a6a0d5b41c970a229cfcaf88e894a5b6395e2dbd0280661f",
      "app": "dbt",
      "method": "api-token",
      "credentials": {
          "instanceUrl": "https://example.dbt.com",
          "accountId": "<YOUR-ACCOUNT-ID>"
      }
  }
}

Create DBT Personal Access Token

Create DBT Connection in Hanzo KMS

Sample request

Sample response

On this page