> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sourcemedium.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# dbt Cloud - Integration Instructions

> Land dbt Cloud job and run metadata in your warehouse as raw tables.

<Note>Raw data only. dbt Cloud lands as warehouse tables. It is not a modeled observability dashboard.</Note>

dbt Cloud runs the transforms that write your warehouse. SourceMedium reads account, job, and run metadata into BigQuery.

<Info>
  You connect data sources yourself in SourceMedium. Sign in to your [SourceMedium account](https://urchin.sourcemedium.com), open your store, then in the **Data sources** section click **Connect data source** and choose the platform. You need an **Editor** or **Admin** role on the store. If you have view-only access, ask an admin or editor on your team to connect it.

  Once it is connected, [what happens next](/docs/data-inputs/platform-integration-instructions/after-you-connect) covers first-sync timing and what each connection status means.
</Info>

## How to connect

<Steps>
  <Step title="Create a read-only service token">
    In dbt Cloud, create a service token with view access to runs, jobs, and projects. Do not use a personal access token.
  </Step>

  <Step title="Request setup">
    Find **dbt Cloud** in the connector picker and click **Request setup**. Send account id, host, and token to your account manager or [integrations@sourcemedium.com](mailto:integrations@sourcemedium.com), not in a public channel.
  </Step>
</Steps>

<Note>
  SourceMedium only ever reads from your connected platforms. It does not create, change, or delete anything, so create the key with **read-only** access wherever the platform offers it. Treat it like a password: keep it confidential and avoid sharing it over email or in spreadsheets. If the credential is rotated or revoked, follow this guide's connection method to update SourceMedium.
</Note>

## What data syncs

Account, job, and run metadata.

### Notes

* Query the warehouse directly until a modeled ops layer exists.