Skip to main content
The PostHog integration pulls product usage out of PostHog and into each customer’s Usage tab and health score.

​
Connecting

Go to Settings → Integrations → PostHog. Two options:
  • Connect with OAuth — sign in to PostHog and approve.
  • Connect with an API key — paste a Personal API key (phx_...) with query:read and endpoint:read scopes, choose your region (US Cloud, EU Cloud, or Self-hosted), and enter your instance URL if self-hosted.

​
Configuring the sync

The sync itself is configured under Product Usage settings:
SettingWhat it does
ProjectWhich PostHog project to pull from
Customer identifierHow PostHog events map to your customers — a group type or an event/person property
EventsOptional allowlist of events to include
ScheduleDaily, weekly, or manual only
BackfillHow many days of history to pull (1–365, default 90)
Before publishing, click Run test sync — it dry-runs the last 7 days and shows which customers matched and which didn’t, so you can fix the identifier mapping before any data lands. Once verified, Publish turns the scheduled sync on.

​
FAQ

Daily metric values per customer (date, customer, metric, value) — not raw event streams.
Their identifier in PostHog doesn’t resolve to a Quivly customer. Adjust the customer identifier setting or the external IDs on your customers.
Schedules are daily, weekly, or manual — daily is the fastest cadence.