Start with one real question and leave with a next step.
Start with the question in front of you, then use the guide to make the next decision easier.
Try saying
“I am trying to make this decision. What should I look at first?”
Start with context
Bring the smallest useful example.
Look for the signal
Separate what is known from what is assumed.
Take one step
Choose an action you can review.
PostHog Integration
What this connection is for
Bring funnels, feature flags, and survey responses beside the customer language that explains them.
How your data reaches Specky
Specky pulls from PostHog on a schedule. A sync runs when you open your workspace if the data is stale, and you can also start one by hand from the integration card.
Before you start
- Personal API Key (Required) — Personal API key from your PostHog project settings.
- Project ID (Required) — Your PostHog project ID, found in Project Settings.
- PostHog Host (Optional) — PostHog Cloud US (default) or EU, or your self-hosted URL.
Setup
Open Settings → Integrations, find PostHog, and click Connect. The form will tell you what to paste and where to find it.
How to create a Personal API Key
- Go to your PostHog project → Settings → Personal API Keys
- Click "Create personal API key"
- Give it a label like
specky-integration - Copy the generated key (starts with
phx_)
Finding your Project ID
- Go to Settings → Project in PostHog
- Your Project ID is displayed at the top of the page
PostHog Host
- US Cloud:
https://us.posthog.com(default) - EU Cloud:
https://eu.posthog.com - Self-hosted: Your custom PostHog URL
Data synced
| Data | Used for |
|---|---|
| Events & trends | User behavior patterns, feature adoption metrics |
| Feature flags | Active experiments, rollout status |
| Surveys & responses | NPS scores, feature requests, user feedback |
| Cohorts | User segmentation for targeted PRDs |
| Session recordings | AI watches each replay for bugs, rage clicks, and UX friction |
How Specky uses PostHog data
- Product Graph: Events and survey responses appear as graph nodes alongside Slack, Jira, etc.
- PRD Generation: AI cites analytics data (e.g., "only 12% of users completed onboarding") when writing specs
- Discovery Workbench: Surface trending events, declining feature usage, and NPS feedback clusters
- Opportunity Tree: Feature flag experiment results feed into opportunity scoring
After connecting
New PostHog items appear in Discovery alongside your other sources. You can search them, ask questions about them, and cite them in product work without opening another tab.
Disconnecting PostHog removes the connection and the signals it brought in.
Troubleshooting
- Connected, but nothing appears. Open the PostHog card and run a sync by hand. If it errors, the card shows the reason.
- "Upgrade to connect". Your plan caps how many integrations you can connect at once, and a few providers are Scale-only. Settings → Usage shows where you stand.
- Credentials stopped working. Tokens expire and get revoked. Reconnect with a fresh one — your existing signals are kept.
See the PostHog integration page for what it's for and the questions people usually ask first, or the Integrations Overview for how integrations work in general.
Ready to apply this?
Start with your own product and keep the first read grounded. You'll create an account before the guided result so it can be saved to your workspace.