SpeckyDocs

PostHog Integration

What it does

Import product analytics, feature flags, and user surveys.

How your data reaches Specky

Specky pulls from PostHog on a schedule. A sync runs when you open your workspace if the data has gone stale, and you can trigger one by hand from the integration card at any time.

What you'll need

  • 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

    Go to Settings → Integrations, find PostHog, and click Connect.

    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

    DataUsed for

    Events & trendsUser behavior patterns, feature adoption metrics Feature flagsActive experiments, rollout status Surveys & responsesNPS scores, feature requests, user feedback CohortsUser segmentation for targeted PRDs Session recordingsAI 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

    Everything Specky pulls in from PostHog shows up in Discovery alongside your other sources, and feeds synthesis, clustering, and the AI chat's answers about your product. You don't have to do anything with it directly — it's there so the rest of Specky has something to reason over.

    Disconnecting PostHog removes both 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.