Skip to main content

Documentation Index

Fetch the complete documentation index at: https://help.superhawk.ai/llms.txt

Use this file to discover all available pages before exploring further.

The PostHog integration brings product analytics and feature adoption data into Superhawk AI. Track how trial users engage with specific features, monitor conversion funnels, and understand which parts of your product drive the most value during trials.

​
Prerequisites

  • A PostHog account with a project set up
  • Your PostHog project API key (found in PostHog under Project Settings)
  • Workspace admin permissions in Superhawk AI

​
Setup

1

Open integrations

Navigate to Settings > Integrations in your Superhawk AI workspace.
2

Find PostHog

Locate PostHog under the Analytics & Monitoring category.
3

Start the connection

Click Connect on the PostHog card.
4

Enter your API key

Paste your PostHog project API key into the field provided.
5

Configure tracking options

Select the tracking options for your integration:
  • Autocapture events — automatically capture page views, clicks, and form submissions
  • Feature flag tracking — sync feature flag evaluations to see which features trial users have access to
  • Custom events — include any custom events your team has instrumented in PostHog
6

Save

Click Save to activate the integration. Data will begin flowing into Superhawk AI within a few minutes.

​
Configuration Options

After connecting PostHog, you can adjust settings from Settings > Integrations > PostHog.
  • Autocapture — toggle automatic capture of page views and interactions on or off.
  • Feature flag tracking — enable or disable syncing of feature flag evaluations to see which trial users have access to specific features.
  • Event filters — limit which custom events are synced to Superhawk AI to keep your trial data focused.

​
Troubleshooting

Make sure you are using the project API key, not a personal API key. Personal keys do not have access to project-level event data.
If you are self-hosting PostHog, you may need to provide your custom PostHog instance URL during setup. Look for the Host URL field in the connection dialog.