diff --git a/src/segment-app/extensions/dbt.md b/src/segment-app/extensions/dbt.md index 2b811103de..c22a932f68 100644 --- a/src/segment-app/extensions/dbt.md +++ b/src/segment-app/extensions/dbt.md @@ -51,7 +51,12 @@ To set up dbt Cloud: 3. Add your dbt Cloud API key or dbt Personal Access Token and an optional custom subdomain, then click **Save**. > info "Adding a custom subdomain" -> By default, dbt sets the subdomain to cloud. To identify your custom subdomain, open your URL and copy the portion before `.getdbt.com`. For example, if your domain was `https://subdomain.getdbt.com/`, your subdomain would be `subdomain`. +> By default, dbt sets the subdomain to cloud. To identify your custom subdomain, open your URL and copy the portion before `.getdbt.com`. For example, if your domain was `https://subdomain.getdbt.com/`, your subdomain would be `subdomain`. + +### dbt Cloud Webhooks +The dbt Cloud integration allows you to schedule Reverse ETL syncs based on a dbt Cloud job. When a dbt Cloud job is selected under the Reverse ETL scheduling section, Segment creates a webhook in the dbt Cloud account that will initiate to run the Reverse ETL sync when the job is scheduled. + +In order to create the webhook, ensure that you have webhook permissions associated with the dbt Cloud token in the previous step. ### Model syncs @@ -109,4 +114,4 @@ The following table lists common dbt Extension errors, as well as their solution | Error | Error message | Solution | | ----------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Failed sync | `Sync Failed: Incorrect dbt Project File Path: dbt project file not found` | Verify that the path to your `dbt_project.yml` file is relative to the repository root, excluding the root branch.
For example, use `project/dbt_project.yml` instead of `main/project/dbt_project.yml`. | -| Failed sync | `Sync Failed: remote: Write access to repository not granted` | Verify that the account associated with the token has a write role in the repository settings. Fine-grained tokens may require specific roles, depending on your Git provider. | \ No newline at end of file +| Failed sync | `Sync Failed: remote: Write access to repository not granted` | Verify that the account associated with the token has a write role in the repository settings. Fine-grained tokens may require specific roles, depending on your Git provider. |