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

# Hex - How do I link my account?

# Overview

To authenticate with Hex, you will need:

1. **Subdomain** – Your Hex subdomain.
2. **API Token** – A personal access token or workspace token that grants Nango permission to interact with the Hex API on your behalf.

This guide explains how to obtain both from Hex.

### Prerequisites

* An active Hex account with Editor or higher role (for personal access tokens), or Admin role (for workspace tokens).

### Instructions

#### Step 1: Creating your API token

1. Log in to your [Hex](https://app.hex.tech) account.
2. Click the settings button.

<img src="https://mintcdn.com/nango/ZdMsgNFRl7aTcpvk/api-integrations/hex/settings.png?fit=max&auto=format&n=ZdMsgNFRl7aTcpvk&q=85&s=681b5cbfc9ee88ea47ca004da48ae94f" width="1900" height="826" data-path="api-integrations/hex/settings.png" />

3. Click the **API Keys** button.

<img src="https://mintcdn.com/nango/ZdMsgNFRl7aTcpvk/api-integrations/hex/api_keys.png?fit=max&auto=format&n=ZdMsgNFRl7aTcpvk&q=85&s=cbdb53abb9ed6a7014f661145ce0d313" width="1913" height="582" data-path="api-integrations/hex/api_keys.png" />

4. Choose the token type, click **New Token**, and fill in the form.
   * **Personal access tokens** (prefix `hxtp_`) inherit your own permissions and require an expiration date.
   * **Workspace tokens** (prefix `hxtw_`) are managed by admins, can be set to never expire, and support different permission scopes.
5. Copy the token immediately — it is shown **once** upon creation and cannot be retrieved later.

<img src="https://mintcdn.com/nango/ZdMsgNFRl7aTcpvk/api-integrations/hex/generated_key.png?fit=max&auto=format&n=ZdMsgNFRl7aTcpvk&q=85&s=e67af1206c7ddbd3a53fd824952a0b6b" width="1913" height="717" data-path="api-integrations/hex/generated_key.png" />

#### Step 2: Finding your subdomain

Your subdomain is the part before `.hex.tech` in the URL you use to access Hex:

* **Standard accounts** → `app` (your Hex URL is `https://app.hex.tech`)
* **EU multi-tenant** → `eu` (your Hex URL is `https://eu.hex.tech`)
* **Single-tenant or HIPAA** → your custom subdomain, e.g. `atreides` (your Hex URL is `https://atreides.hex.tech`)

If you are unsure, check the URL in your browser when logged into Hex.

#### Step 3: Enter credentials in the Connect UI

1. Open the form where you need to authenticate with Hex.
2. Enter your **Subdomain** in the Subdomain field.
3. Enter your **API Token** in the API Token field.
4. Submit the form to complete authentication.

<img src="https://mintcdn.com/nango/ZdMsgNFRl7aTcpvk/api-integrations/hex/form.png?fit=max&auto=format&n=ZdMsgNFRl7aTcpvk&q=85&s=9e6cb7610006142ed946aeae969193eb" style={{maxWidth: "450px" }} width="996" height="1328" data-path="api-integrations/hex/form.png" />

You are now connected to Hex.