Skip to Content

PostHog

Connecting PostHog gives agents the ability to query your product analytics — events, feature flags, experiments, session recordings, and more.

What agents can do

Once connected, agents have access to a broad set of PostHog capabilities:

  • Query events — Run HogQL queries and retrieve event data for your project.
  • Feature flags — List, inspect, and update feature flags.
  • Experiments — View experiment results and stats.
  • Session recordings — Access recording lists and metadata.
  • Cohorts — Create and manage cohorts for targeted analysis.
  • Dashboards and insights — Read and update dashboards, create new insights.

Connecting

PostHog uses API key authentication. You will need a PostHog Personal API key (or a project API key with appropriate permissions).

Generating an API key

  1. In PostHog, go to SettingsPersonal API Keys.
  2. Click Create personal API key, give it a name, and copy the key.

Connection steps

  1. Go to SettingsConnections in Alma.
  2. Click Connect on PostHog.
  3. Enter your PostHog API key in the dialog and click Connect.

PostHog is an organization-level connection — once connected by an admin, all agents in the workspace can use it.

Disconnecting

Click Disconnect on the PostHog connection card to revoke access. Agents will no longer be able to query PostHog data.

Last updated on