PostHog (Source)

Source - Vendo reads product analytics data from PostHog Cloud or self-hosted PostHog and makes it available for warehouse reporting, Vendo models, and downstream activation.

What Vendo Syncs

Data	Description
Events	Product and analytics events, including `$autocapture`, pageview, and custom events
Persons	Identified user profiles, properties, distinct IDs, and identify history
Groups	Organization, company, or account records with group properties
Session Recordings	Session recording metadata such as ID, start time, end time, duration, and person reference; recording blobs are not imported

Identity Handling

PostHog source data keeps PostHog’s identity model intact while mapping it into Vendo’s canonical entities.

Vendo concept	PostHog field
Event user ID	`distinct_id`, with `person_id` as an alternate
Event name	`event`
Event timestamp	`timestamp`
Event dedupe ID	`uuid`
Person user ID	`distinct_ids`, with `id` as an alternate
Person timestamp	`updated_at`
Group ID	`group_key`

Groups are imported as Vendo group records with a default group type suitable for company/account analytics.

Platform Details

Setting	Value
Auth Method	Personal API key for reads
Required Fields	Host, project ID, personal API key
Supported Hosts	US Cloud, EU Cloud, and self-hosted PostHog
Events Fetch Method	Cursor REST windows using event timestamps
Persons Fetch Method	Snapshot import
Groups Fetch Method	Snapshot import
Session Recording Fetch Method	Cursor REST windows using start time

Setup

In PostHog, create or copy a personal API key from My Settings > Personal API Keys
Find the numeric project ID in Project Settings > General
In Vendo, navigate to Sources > PostHog
Select the PostHog host: US Cloud, EU Cloud, or Self-hosted
For self-hosted PostHog, enter the base URL of your PostHog instance
Enter the project ID and personal API key
Choose the resources to import and save the source

Verify Setup

Confirm the PostHog source status is active in Vendo
Trigger a manual sync or wait for the next scheduled import
Check that event, person, and group tables are populated
Confirm that event counts for a recent day roughly match PostHog for the same project and time zone
Review integration logs for authentication, host, or project ID errors

Troubleshooting

Symptom	What to check
Authentication fails	Confirm the personal API key starts with `phx_` and has access to the selected project
Empty events	Check that the project ID and host match the project that contains the events
Self-hosted connection fails	Confirm the self-hosted URL is reachable by Vendo and does not include a trailing API path
Group data is missing	Confirm group analytics is enabled and that groups have been identified in PostHog
Session recording rows are missing	Confirm the project has session recordings; Vendo imports metadata only, not recording blobs