Skip to main content
This extension requires a paid Hightouch plan
dbt requires you to have a paid plan to use this extension
The dbt Cloud extension allows you to:
  • Schedule Hightouch syncs to run as soon as a dbt Cloud job completes. Relying on dbt Cloud for sync scheduling ensures that Hightouch performs syncs when fresh data is available.
  • Sync models from dbt into Hightouch
Extension setup requires connecting your dbt account to Hightouch.

​
Connect to dbt Cloud

Open the dbt Cloud configuration page in your workspace and enter the dbt Cloud URL. Depending on your setup, you need to insert:
  • for regular dbt Cloud setups, a default access URL
  • for accounts with cell-based account prefixes, you can find the custom unique access URL in dbt on the Account settings page (below the Account information pane)
These are the most commonly used default access URLs:
  • ​­­https://cloud.getdbt.com​, for the US
  • ­https://emea.getdbt.com​, for EMEA
Then navigate to dbt Cloud and generate a service account token or a personal access token (PAT). In Hightouch, enter your token in the dbt Cloud API token field in the Configuration tab of the dbt Cloud extension. Click Connect to complete your connection configuration.
A Member-level or higher service account token is required.
Read-only tokens are no longer supported because the dbt Cloud integration uses webhooks, which require elevated permissions.
If you previously used a read-only dbt Cloud token, you must update to a Member token (or higher). Without this change, Hightouch syncs triggered by dbt Cloud will fail.
To update your dbt Cloud API token in Hightouch, edit your credentials within the extension and set a new API token. This won’t reset the schedule configuration of syncs that use the dbt Cloud scheduling method, nor are any synced models removed.

​
Configure sync schedules

When creating or modifying a sync you can select dbt Cloud as a schedule type.
  1. Go the Schedule tab of overview page of the sync to schedule. Select dbt Cloud as the schedule type.
  2. Select the appropriate dbt Account and Job.
  3. Click Save.
dbt Cloud schedule configuration in the Hightouch UI Your sync is now scheduled to run whenever your chosen dbt Cloud jobs complete.
The sync won’t get triggered if your dbt Cloud job fails.

​
dbt Cloud model sync

To sync models from dbt Cloud to Hightouch, the extension requires a Member-level or higher service account token as described in the preceding section. A webhook ID should display next to your account status. dbt Cloud connections

​
Connecting a source

On the extension configuration page there is a list of sources from your workspace within Hightouch that can be connected to dbt Cloud. Choose one that you would like to configure and click “Connect to dbt.” dbt Cloud - connection configuration Configure the dbt Cloud account and job from the dropdowns, then choose “Create Configuration” dbt Cloud - connection configuration details
Select a dbt job that has a “Compile” step (compile, build, run) or no model artifacts get produced.

​
Syncing models

Once configured, the “dbt to Hightouch” status shows “Waiting to be synced.” If your job in dbt Cloud has previous runs you can click the “refresh” button to manually sync models from the job’s result. Otherwise, run the job within dbt Cloud and the result should trigger the update in Hightouch. After a successful run, dbt Cloud models are available within Hightouch. dbt cloud model picker
A dbt Cloud job can fail and still produce model artifacts which sync to Hightouch.

​
dbt Cloud model sync advantages

Along with the advantages of using dbt models that dbt Core brings, dbt Cloud brings more helpful features:
  • dbt Mesh: reference models in other projects ({{ ref('customers', 'contact_info') }})
  • “Versionless” (now called “Latest”) - always runs your compile job with the latest dbt version
  • Private dependencies
  • Database adapters that Hightouch doesn’t support for dbt Core (such as Fabric)
Last modified on April 1, 2026