# Trigger Hex Projects

Learn how to automatically trigger Hex projects when your dbt™ runs complete successfully in Bolt. This integration helps data teams maintain up-to-date dashboards by refreshing Hex projects immediately after successful pipeline runs.

### What You'll Get

When a run succeeds, Bolt automatically triggers your Hex project:

* Webhook triggers automatically
* Hex project refreshes with latest data

<figure><img src="https://2337193041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHET0AD04uHMgdeLAjptq%2Fuploads%2F2PKa6Taj18ZTLyGxxAew%2Fimage.png?alt=media&#x26;token=fbfc7136-70d8-4d3a-9e04-d1d7dd531f6a" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}

#### Key Benefits for Data Teams

* Automatic Hex project updates after successful Bolt runs
* Real-time dashboard refreshes
* Streamlined workflow between dbt™ pipelines and Hex analytics
* Always current visualizations and reports
  {% endhint %}

{% hint style="warning" %}

#### Prerequisites for Hex Integration

* Existing [Bolt schedule](https://app.paradime.io/bolt)
* Admin access to Hex
* Hex [workspace token](https://learn.hex.tech/docs/explore-data/notebook-view/hex-api/hex-api-overview#workspace-tokens) (API Key)
* Project UUID from your Hex project
  {% endhint %}

***

### Setup Guide

Set up Hex project updates for successful runs. Follow the steps below, and watch our [interactive tutorial](#step-3-test-the-integration).

#### Step 1: Gather Your Hex Credentials

1. **Get Your Project UUID**:
   * Find the UUID in either:
     * The URL after `/hex/`
     * The Variables view in the sidebar

<figure><img src="https://2337193041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHET0AD04uHMgdeLAjptq%2Fuploads%2FABDtJj3SwNBC6Wos0wPD%2Fimage.png?alt=media&#x26;token=0398af5f-f26f-48ae-a2d0-0095e5365260" alt=""><figcaption></figcaption></figure>

2. **Generate API Key**:

* Go to Settings > API Keys
* Create a new [workspace token](https://learn.hex.tech/docs/explore-data/notebook-view/hex-api/hex-api-overview#workspace-tokens)
* Save the token securely

#### Step 2: Configure the Webhook In Paradime

1. From the [Bolt](https://app.paradime.io/bolt) home screen, go to [Templates](https://app.paradime.io/bolt/templates)&#x20;
2. Click "Trigger Hex Project"
3. Enter your Hex Credentials:
   * Project UUID
   * API Key (Workspace Token)
4. Click "Connect"

<figure><img src="https://2337193041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHET0AD04uHMgdeLAjptq%2Fuploads%2Fn4a46stalO5ZrP992Wer%2Fimage.png?alt=media&#x26;token=5e438f88-bc0a-4bff-b272-b50aefee2f90" alt=""><figcaption></figcaption></figure>

#### Step 3: Test the Integration

1. [Run a Bolt schedule manually](https://docs.paradime.io/app-help/documentation/managing-schedules/schedule-configurations#trigger-a-run-manually) (the webhook triggers only on successful runs)
2. After the run succeeds:
   * From the Bolt homescreen, go to Webhooks
   * Select your Hex Project Webhook
   * Check the Endpoints tab to verify the webhook triggered
   * Verify your Hex dashboard has updated

{% @arcade/embed flowId="KI8qI3B8o3lP9QLdoPBE" url="<https://app.arcade.software/share/KI8qI3B8o3lP9QLdoPBE>" %}