Skip to content
Last updated

Hex integration

Hex is a collaborative data workspace for building, sharing, and iterating on analyses, notebooks, and data apps. The Frontegg integration connects to the Hex API using an API token to manage projects, runs, users, groups, collections, and data connections.


Prerequisites

  • A Hex workspace with Admin access (required to create workspace tokens)

Generate an API token

Step 1: Open your workspace settings

In your Hex workspace, click Settings in the left sidebar.

Hex workspace sidebar with Settings highlighted

Step 2: Navigate to API keys

In the Settings panel, select the API keys tab, then click New token under the Workspace tokens section.

Hex API keys settings with New token button highlighted

Step 3: Configure the token

In the New workspace token dialog:

  1. Enter a Description, for example Frontegg Integration.
  2. Set Expiration to No Expiry.
  3. Select the required API scopes:
ScopeAccess required
Sync semantic projectsEnabled
ProjectsRead + Write + Run + Read queried tables
UsersRead + Write
GroupsRead + Write
CollectionsRead + Write
Data connectionsRead + Write
CellsRead + Write
GuidesRead + Write
  1. Click Generate token.

New workspace token dialog with scopes selected and Generate token highlighted

Step 4: Copy the token

Copy the generated token immediately — it is shown only once and cannot be retrieved later.

Generated workspace token with Copy token button highlighted

Configure the Frontegg portal

Once you have your API token, enter it in the Frontegg portal:

  1. Open the Frontegg portal and navigate to [ENVIRONMENT]IntegrationsHex.
  2. Enter the API Key you copied in the previous step.
  3. Click Save.

Keep your token secure

Never share or commit your API token to version control. If a token is compromised, revoke it from SettingsAPI keys and generate a new one.

Additional resources