Merge pull request #7313 from segmentio/kurt-lu-patch-1

Update dbt Extension

Author: pwseg

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. <br> 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.                                |
+| 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.                                |