PostHog integration

The PostHog integration pulls each contact's acquisition utm parameters into EngageApp so you can attribute contacts to the campaign or source that brought them in — and segment on it. Connecting is a one-time setup done by an owner or admin.

What it does

Once connected, EngageApp queries your PostHog project (via PostHog's HogQL query API) and enriches each contact with the UTM parameters from their acquisition — such as utm_source, utm_medium, and utm_campaign. Those become attributes you can filter and report on, so you can answer which sources produce your most engaged contacts.

Connect your project

1. Open the Integrations page. Only an owner or admin can add a connection.
2. Select PostHog and provide your credentials: a PostHog personal read key plus your host and project. The read key needs access to run queries against the project.
3. Save. EngageApp encrypts your credentials at rest and verifies them at save time by making a test call — if the key, host, or project is wrong, the save is rejected so you catch mistakes immediately.

Use the enriched data

After the connection is verified, the pulled UTM attributes appear on your contacts. Build a dynamic segment such as "utm_source is paid_search" to target contacts by how you acquired them, or compare performance across sources in your analytics.

Manage the connection

You can review, update, or remove the PostHog connection at any time under Settings → Integrations. Rotate the read key there if it changes in PostHog; the new credentials are re-verified when you save.

Next steps

• Combine acquisition data with behavioral events.
• See how attributes attach to your contacts.
• Measure source performance in analytics.