Apps, projects, and environments are organizational concepts separating data and definitions in Heap. An application (your Heap account) has one or more projects (tracked products and applications) that each have one or more environments (groupings of data). These ID types correspond to these concepts, and differ based on what they are identifying and the context in which they are meant to be used.
Each app has one Main project by default, and each project comes with one production environment. Most Heap users primarily operate out of the default Main Production environment, so understanding the nuances of these IDs and when to use them is important.
App ID
The app_id refers to the ID attached to your entire Heap account. You only have one app ID. Your app ID is your Main Production environment ID.
The app ID is primarily used for managing Teammates, configuring SSO (since this grants access to the entire account), and evaluating your account size. In cases where the app ID and env ID are the same (Main Production) it can also be used for installing Heap.
How to find your app ID
To find your app ID, navigate to Account > Manage > Projects and click on the project with the name Main and environment Production. In the details panel, scroll down to the Environments section, then copy the Production ID.
Env ID
The env_id refers to the ID attached to a specific environment. Since you can have multiple environments, you can have multiple env IDs. In the case of your default environment, Main Production, your app ID and env ID are the same.
The env ID is primarily used for installing Heap and connecting to warehouses via Heap Connect, since it’s specific to the environment that you’re collecting data for.
How to find your env ID
To find an environment, navigate to Account > Manage > Projects and click on the project associated with the environment you want the ID for. In the details panel, scroll down to the Environments section, then copy the relevant environment ID.