Skip to main content
The PostHog integration connects Kestrel to your PostHog instance, enabling product analytics events to trigger workflows and giving AI agents access to session recordings, error data, and event queries for investigation.

​
Prerequisites

  • Organization Admin role in Kestrel
  • PostHog account with API access
  • PostHog API key (Personal API Key) and Project ID

​
Setup

1

Get your PostHog credentials

  1. In PostHog, go to Settings → Project → Project API Key and copy your Project ID
  2. Go to Settings → User → Personal API Keys and create a new key
  3. Copy the generated API key
2

Connect in Kestrel

  1. Navigate to Integrations → PostHog in your Kestrel dashboard
  2. Click Connect
  3. Paste your API Key and Project ID
  4. Enter your PostHog instance URL (e.g., https://app.posthog.com or your self-hosted URL)
  5. Click Connect PostHog

​
How It’s Used

​
In Workflows

Trigger blocks:
  • Session Error/Exception — fires when PostHog captures an unhandled exception in a session
  • Console Error — fires on console error patterns matching your filter
  • Rage Click — fires when a user exhibits rage click behavior
  • Any PostHog Event — fires on any PostHog event matching your configured criteria
  • Log Error Alert — fires when PostHog log error patterns exceed your configured threshold
Action blocks:
  • Get Session Summary — retrieve an AI-generated summary of a user session
  • Get Session Recording — fetch session recording details and metadata
  • Query Events — run PostHog event queries with filters and date ranges
  • List Session Recordings — list session recordings matching specified filters
  • Get Error Issue — retrieve error group details and exception information
Example: A workflow triggers on a spike in rage clicks, queries the relevant session recordings, summarizes the user experience issue, and creates a Linear issue with the findings.

​
Disconnecting

  1. Navigate to Integrations → PostHog
  2. Click Disconnect
  3. Confirm the disconnection