This setup should take 5 minutes.
1. Create Token in Hex
There are two options for connecting Foundational with Hex:
Option 1: Workspace Token (Recommended)
A read-only token that provides workspace-level access
More secure as it has limited permissions
Ideal for data ingestion purposes
Option 2: Personal Access Token (PAT)
Uses your personal user permissions
May have broader access than needed
Ingestion will be done with your user's permissions
In order to create the token, please follow these steps:
Go to your Hex workspace settings
Navigate to the API keys section
Choose either "Workspace Token" (recommended) or "Personal Access Token"
For Workspace Token: ensure it has read-only permissions
Copy the generated token aside, we will use it in the next step
2. Configure Hex in Foundational
Open the Integrations page in Foundational
Fill in the following information:
Hex Base URL
The URL of your Hex workspace. This is the web address you use to access Hex, for example: https://app.hex.tech or https://yourcompany.hex.tech
You can find this in your browser's address bar when you're logged into Hex.
Workspace Name
The name of your Hex workspace. This is typically your organization or team name within Hex.
You can find this in your Hex workspace settings or in the URL path when navigating through your workspace: https://app.hex.tech/<workspace_name>
Hex Token
An API Bearer token that allows Foundational to access your Hex workspace. Hex supports two types of authentication tokens: