Welcome to Encatch Docs
Data syncBetaConnectorsAnalytics

PostHog

Send Encatch survey events to PostHog - where to find the details in PostHog and how to set up the connection

Overview

The PostHog connector sends survey events to a PostHog Cloud project as captured events, so survey moments sit on the same timeline as the rest of your product analytics.

What it getsSurvey events as captured events
EventsSurvey shown, started, submitted, partially submitted and dismissed
Anonymous respondentsSupported, with Include anonymous respondents on
User profileNot updated yet: events only
StatusAvailable

What You'll Need

Before you start, make sure you have:

  • A PostHog Cloud project — on US Cloud or EU Cloud
  • Its Project ID and Project API key — from the project's settings (Step 1)

Step 1: Get your project details in PostHog

  1. In PostHog, open Settings → Project → General.
  2. Copy the Project ID.
  3. Copy the Project API key. It starts with phc_.
  4. Note your region from the address you sign in at: us.posthog.com is US Cloud, eu.posthog.com is EU Cloud.

Step 2: Add the connection in Encatch

  1. In Encatch, open Data sync → Survey events and click Add connection.
  2. Choose PostHog.
  3. Enter a Name you'll recognise in the list and in Logs.
  4. Fill in the PostHog settings:
FieldWhat to enter
RegionUS Cloud (default) or EU Cloud.
Project IDThe Project ID.
Project API keyThe Project API key (phc_…).
  1. Press Test connection. Encatch shows what PostHog answered.

Encatch keeps the keys encrypted and never shows them again. To change one later, press Replace.


Step 3: Choose what to send

  1. Under Surveys, choose All surveys or Only these surveys.
  2. Under What is sent, tick the events to send. A new connection starts with Survey shown, started, submitted and dismissed ticked. Survey partially submitted is off until you tick it.
  3. Rename an event if you want another name in PostHog. The defaults are encatch_survey_shown, encatch_survey_started, encatch_survey_submitted, encatch_survey_partial and encatch_survey_dismissed.
  4. To also send responses of people who are not signed in, turn on Include anonymous respondents.
  5. Open Advanced options to choose how users are identified, whether answers are sent and the rate limit.

Every option is explained in Connection settings.


Step 4: Save and start sending

Click Save. Saving does not start sending: press Start sending when you are ready. From then on events go out as they happen, and every delivery is listed in Logs.


Check it in PostHog

Test connection sends one event named encatch_test_event. Open Activity in PostHog to see it arrive, then watch for your survey events under the names you chose.


Good to know

  • PostHog Cloud only. The connector sends to PostHog's US and EU Cloud.
  • Events only. PostHog gets the events; Encatch does not set person properties in PostHog yet, so Update the user's profile is shown off.
  • Anonymous respondents arrive under the device ID as the distinct ID.
  • Rate limit. PostHog has no request limit on event capture, so a limit is rarely needed.

Troubleshooting

What you seeWhat it meansWhat to do
Delivered, but nothing in PostHogThe region or the Project API key belongs to another projectCheck the address you sign in at, and copy the key again from the same project

Was this page helpful?