PostHog
AnalyticsTestedProduct analytics — events, funnels, retention, cohorts, feature flags, session replay, and ad-hoc HogQL queries.
OVERVIEW
PostHog is the open-source product analytics platform that product-led teams use to understand how people actually use their product: funnels, retention, cohorts, feature flags, and session replay, all in one place. Agentcy connects to your PostHog project's API and answers product questions in plain language, so you do not have to build an insight or write a query by hand every time.
The power tool under the hood is HogQL (PostHog's SQL). When you ask a quantitative question like "how many signups did we get in the last 30 days" or "what is our week-over-week retention," Agentcy writes and runs the HogQL for you, then hands back the synthesized answer instead of a raw result grid. It can also read your saved insights and their computed numbers, list the events and properties you track, and surface cohorts, feature flags, dashboards, and recent session recordings.
PostHog is a BYOK (Bring Your Own Key) service. You create a read-scoped Personal API Key, pick your region (US or EU Cloud, or your self-hosted host), and provide your numeric Project ID. Credentials are configured per domain and stored securely. Agentcy is read-only: it never writes events, flags, or anything else into PostHog.
EXAMPLE QUESTIONS
14 SAMPLES“What insights are saved in PostHog and what do they show?”
“How many signups did we get in the last 30 days in PostHog?”
“What is the conversion funnel from signup to activation in PostHog?”
“What is our weekly user retention in PostHog?”
“Run HogQL to break PostHog events down by type this month”
“How many persons are tracked in PostHog and who are the most recent?”
“What events happened in the last 7 days in PostHog?”
“What event definitions are we tracking in PostHog?”
“What property definitions can I filter PostHog events by?”
“What cohorts are defined in PostHog?”
“What feature flags are active in PostHog?”
“What dashboards do we have in PostHog?”
“What annotations are on our PostHog timeline?”
“How many session recordings were captured recently in PostHog?”
WHAT YOU CAN ASK ABOUT
11 EXAMPLESREQUIREMENTS
- Google Account
- Not required
- API Key
- Provide your own API credentials
- External Subscription
- PostHog account (Cloud or self-hosted). The free tier includes API access (1M events/month, no credit card). Some high-volume query usage may require a paid plan.
- Domain Configuration
- PostHog Personal API Key (read scopes), numeric Project ID, and API Host (US, EU, or self-hosted) — configured per domain in the Agentcy portal
SETUP
7 STEPS- 01
In PostHog, go to Settings → Personal API Keys → Create personal API key
- 02
Give it read scopes (insight, query, person, event, cohort, session_recording, feature_flag, dashboard, annotation) or all-access read, and copy the phx_ key
- 03
Note your Project ID (Settings → Project) and your region host: US Cloud is https://us.posthog.com, EU Cloud is https://eu.posthog.com, or use your self-hosted URL
- 04
In the Agentcy portal, go to Services and enable PostHog for your account
- 05
Toggle on the domain you want to connect, then click Set up on PostHog
- 06
Paste your Personal API Key, enter the Project ID and API Host, and click Test Connection to verify access
- 07
Start asking product-analytics questions in plain language
DATA FRESHNESS
5-minute cache. PostHog product data updates continuously; recent events are available within minutes. Note PostHog API rate limits are team-wide, so caching keeps usage efficient across multiple connected projects.
TIPS
6Personal API Keys are scoped — a key missing the right read scopes returns 403 on some operations. Give it read scopes for insight, query, person, event, cohort, session_recording, feature_flag, dashboard, and annotation (or all-access read).
Pick the correct region host: an EU-Cloud key only works against https://eu.posthog.com, and a US key only against https://us.posthog.com.
The Project ID is the numeric id in your PostHog URL, not the project name.
Trends, funnels, and retention are answered via HogQL (PostHog's modern query engine); the older standalone insight endpoints are deprecated, so Agentcy uses HogQL for these automatically.
Session recordings return metadata only (duration, counts) — not replay content.
Read-only by design: Agentcy never writes events, flags, or any data into PostHog.
WORKS WELL WITH
2 SERVICESGoogle Analytics 4
Connect marketing-attributed acquisition (GA4) to in-product activation and retention (PostHog) for a full-funnel view
Stripe
Tie product usage and activation events to revenue, MRR, and churn from Stripe