---
title: Hex
description: >-
  Connect Hex to Datadog Data Observability to view field-level lineage from
  warehouse tables to Hex projects and SQL cells.
breadcrumbs: >-
  Docs > Data Observability Overview > Quality Monitoring > Business
  Intelligence Integrations > Hex
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Hex

{% callout %}
# Important note for users on the following Datadog sites: app.ddog-gov.com, us2.ddog-gov.com

{% alert level="danger" %}
This product is not supported for your selected [Datadog site](https://docs.datadoghq.com/getting_started/site.md). ({% placeholder "user-datadog-site-name" /%}).
{% /alert %}

{% /callout %}

## Overview{% #overview %}

Datadog's Hex integration helps data teams view end-to-end lineage between warehouse tables and Hex projects. The integration collects metadata and field-level lineage for objects in your Hex workspace. When Datadog connects, it:

- Pulls metadata from your Hex workspace, including projects and SQL cells
- Generates field-level lineage between warehouse tables and columns and downstream Hex projects and SQL cells
- Derives lineage for all [supported data warehouse destinations](https://docs.datadoghq.com/data_observability/quality_monitoring/data_warehouses.md)

## Setup{% #setup %}

### Create a Hex workspace token{% #create-a-hex-workspace-token %}

1. In your Hex workspace settings, go to the API keys page.
1. Click New Token to generate a workspace token.
1. Provide a description and an expiration time frame. Datadog recommends setting up a token with no expiration.
1. For the API scopes, select Read Access under Projects, Cells, and Data connections.

### Add the API credentials to Datadog{% #add-the-api-credentials-to-datadog %}

1. Navigate to the [Hex integration tile](https://app.datadoghq.com/integrations/hex).
1. Click Configure > + Add New Account.
1. Fill out the form with the following:
   - API Token: The token from the previous step
   - Workspace URL: Required only if you are a single-tenant, EU multi-tenant, or HIPAA multi-tenant customer. Leave empty otherwise.
1. Click Save.

## What's next{% #whats-next %}

It can take up to 60 minutes for data to appear after the initial setup.

After syncing, you can explore your Hex projects and their upstream warehouse dependencies in the [Data Observability Catalog](https://app.datadoghq.com/data-obs/catalog).

## Further reading{% #further-reading %}

- [Learn about Data Observability](https://docs.datadoghq.com/data_observability.md)
