> ## Documentation Index
> Fetch the complete documentation index at: https://nango-marcin-get-deployments-docs.mintlify.site/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-marcin-get-deployments-docs/pMmrQEHxzzVBg1I3/api-integrations/hex/settings.png?fit=max&auto=format&n=pMmrQEHxzzVBg1I3&q=85&s=da5220b4254e4bdc667e91295679b545" width="1900" height="826" data-path="api-integrations/hex/settings.png" />

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

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/pMmrQEHxzzVBg1I3/api-integrations/hex/api_keys.png?fit=max&auto=format&n=pMmrQEHxzzVBg1I3&q=85&s=25d3d7084847d22d5163e9f5b45f1206" 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-marcin-get-deployments-docs/pMmrQEHxzzVBg1I3/api-integrations/hex/generated_key.png?fit=max&auto=format&n=pMmrQEHxzzVBg1I3&q=85&s=2ce271736f5117806b6825211aec58cb" 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-marcin-get-deployments-docs/pMmrQEHxzzVBg1I3/api-integrations/hex/form.png?fit=max&auto=format&n=pMmrQEHxzzVBg1I3&q=85&s=e1e1a0fbaa3193f388c18867d8eff2b5" style={{maxWidth: "450px" }} width="996" height="1328" data-path="api-integrations/hex/form.png" />

You are now connected to Hex.