Docs/Integrations/PostHog

PostHog

Turn PostHog exceptions into triage-ready drafts

The PostHog integration turns production errors into triage-ready feedback. When you connect PostHog, Flowback automatically forwards every $exception event into your inbox. Each unique error becomes one draft, complete with a PRD, a suggested priority, and deep links back to the PostHog issue and session replay.

Connecting PostHog

To connect PostHog:

  1. Navigate to Integrations in your dashboard
  2. Click Connect PostHog
  3. You'll be redirected to PostHog to authorize Flowback
  4. Approve the request to be redirected back to Flowback

Flowback sets up the exception forwarding for you automatically — there's nothing to configure inside PostHog. You finish by mapping environments to channels (below).

Configuration

From PostHog Settings you map each PostHog environment to a Flowback channel:

  • Channel — Which channel an environment's exceptions are imported into, or Do not import to ignore it
  • Exceptions — Whether $exception events from that environment become drafts
  • Enabled — Turn a mapping on or off without deleting it

PostHog exceptions always arrive as drafts for review — nothing is created automatically.

Tip
Route your production environment to a high-signal channel and leave noisy staging environments on Do not import.

What gets created

Each unique exception becomes a draft in the mapped channel with:

  • Title — Derived from the exception type and message
  • PRD — A structured spec covering summary, user impact (affected user, page, browser, OS), severity, business risk, acceptance criteria, and the technical evidence from PostHog
  • Suggested priority — Based on the exception level (fatal → Urgent, error → High, warning → Medium, info → Low). Unhandled exceptions are raised a level, and common browser noise is kept low
  • Deep links — Links to the PostHog issue, the session replay (when available), and the affected page

Repeat occurrences of the same error update the existing draft rather than creating a new one. If you approve a draft into an issue, it stays in sync with PostHog.

Note
A Flowback draft corresponds to a single PostHog error. If PostHog groups several errors into one issue, you may see more than one Flowback draft for that issue.

Disconnecting

You can disconnect PostHog at any time from the Integrations page. Disconnecting:

  • Stops new exception drafts from being created and removes the forwarding from PostHog
  • Removes the connection from Flowback
  • Does not delete any existing drafts, submissions, or issues in Flowback

You can reconnect at any time.