Skip to main content
Qualitative feedback tells you what customers say. PostHog tells you what they do. Connecting it lets an agent run SQL against your product analytics mid-run, so a recommendation can cite behaviour as well as quotes.
PostHog integration settings

​
Connect

PostHog uses an API key rather than a redirect.

Open the connect form

Click Connect on the PostHog card. A form opens.

Fill in the three fields

  • Region. US or EU, matching where your PostHog project lives.
  • Project ID. From PostHog under Settings, then Project.
  • API key. A personal API key, created in PostHog under Settings, then Personal API keys.

Submit

Submit and the card turns green. One connection covers one PostHog project.

​
What it brings in

Nothing from PostHog becomes a signal. It’s a query surface for agents, not a source of customer voice.

​
Triggers

One trigger, Event captured. It fires when PostHog forwards an event to Squad from a webhook destination you set up on your side. PostHog’s destination filters decide which events get forwarded, so you define what this trigger reacts to. The PostHog detail page in Squad shows the webhook endpoint to paste into that destination, with a copy button.
Filter tightly in PostHog. A destination pointed at a high-volume event will start an agent run every time it fires.
The destination also has to send the shared secret header Squad checks, x-squidge-webhook-secret. The app shows the URL but not the secret value, so ask support for it when you configure the destination.

​
Tools

Run HogQL query does the real work. Events, trends, funnels and retention are all expressed as SQL.

​
A worked example

You have an insight claiming customers abandon onboarding at the workspace-invite step. Ask an agent with PostHog read tools to check it. It writes a HogQL query counting how many users reach each onboarding step over the last 30 days. The rows either confirm the drop-off or show the complaint is louder than the behaviour, and that answer goes into the brief as a number rather than a hunch.

​
Limits

Queries return the first 100 rows, so aggregate in the query rather than pulling raw events. One project per connection. The trigger fires for whatever your PostHog destination forwards, which makes filtering in PostHog the only volume control you have.