PostHog
Overview
PostHog is a product-analytics platform for tracking user behavior, running experiments, managing feature flags, and building insights and dashboards from event data. Connect PostHog to Suger so the Suger AI agent can query your product analytics — pulling events, insights, and cohorts, inspecting feature flags and experiments, and surfacing usage trends — so product signals inform your marketplace and revenue workflows.
Org-Level vs User-Level
Org-Level Only: PostHog connects at the organization level using a PostHog Personal API Key. The connection is shared across your organization.
Create Integration (Org-Level)
Prerequisites
- A PostHog account with a Personal API Key (PostHog → Settings → Personal API Keys) scoped to the resources you want Suger to access
- Your PostHog region host —
https://us.posthog.com(default) orhttps://eu.posthog.comfor EU
Authenticate by API Key
- Navigate to Settings > Integrations
- Click Connect PostHog
- Paste your PostHog Personal API Key
- Set your host (
https://us.posthog.comby default, orhttps://eu.posthog.comfor EU) - Save, then click Verify to confirm the connection
Suger AI Tools
When PostHog is connected, the Suger AI agent can query and manage your PostHog project through Suger’s built-in tools (66 actions). Capabilities are grouped below.
Org-level: Tools run against the organization’s connected PostHog project.
| Capability | What the agent can do |
|---|---|
| Events & capture | Ingest and query events (e.g. capture-event, list-events, identify-person) |
| Persons & identities | Manage user profiles (e.g. create-person, get-person, list-persons) |
| Insights & dashboards | Build analytics insights and dashboards (e.g. create-insight, list-insights, create-dashboard) |
| Feature flags & experiments | Manage flags and A/B experiments (e.g. create-feature-flag, create-experiment) |
| Cohorts & actions | Define segmentation cohorts and saved event patterns (e.g. create-cohort, create-action) |
| Definitions & metadata | Inspect event and property definitions (e.g. list-event-definitions, get-property-definition) |
| Alerts, annotations & surveys | Manage alerts, annotations, and surveys (e.g. create-alert, create-annotation, create-survey) |
| Projects & session recordings | List projects and session recordings (e.g. list-projects, list-session-recordings) |
Edit Integration
Editing is not supported. Delete and recreate.
Delete Integration
Deleting removes the integration and revokes the stored PostHog credential from Suger.