# Hex (beta)

To connect Hex to Select Star, you will need to...

1. [Create an API key in Hex](#id-1.-create-an-api-key-in-hex)
2. [Create a new datasource in Select Star](#id-2.-create-a-new-data-source-in-select-star)

{% hint style="info" %}
The integration with Hex currently only supports project level lineage and does not support chart level lineage. This is due to a limitation in the metadata provided via Hex APIs.
{% endhint %}

## 1. Create an API Key in Hex

1. Go to Hex and sign in with your account
2. Once logged in, click on settings icon (at the bottom left of the screen)
3. Under **Account,** select **API keys**
4. Create new **Workspace token**:

   * provide a meaningful description
   * set an appropriate duration for the expiration date (recommend `no expiration`)
   * set the API Scope to `Read projects`

   ![](https://3470314135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MgAiVthA_yg9UXKuhyY%2Fuploads%2Fgit-blob-66914a1a12581b31606ff40e878a324b462b92a0%2Fhex-key.png?alt=media)
5. Once the key is generated, copy it to use to connect to Hex in Select Star.

## 2. Create a New Data Source in Select Star

* **Display Name** - The name you want to give to your new data source.
* **API Key** - The workspace token created in Hex from step 1.
* **Hex URL** - The URL copied from your hex instance, such as `https://app.hex.tech/selectstar/`, composed of two key parts:
  * **Base URL** - The primary domain of your Hex instance (e.g., `https://app.hex.tech`).
  * **Site ID** - The unique identifier for your specific workspace or site (e.g., `selectstar`)

![Create Data Source](https://3470314135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MgAiVthA_yg9UXKuhyY%2Fuploads%2Fgit-blob-2515f17bc1c6b1b7fc9be72972f4d4b62d1d6ca3%2Fhex-form.png?alt=media)

Your metadata should start loading automatically, and once the sync is complete you'll be able to see Hex projects and their lineage in Select Star.