PostHog

PostHog connections are available in the Limerence desktop app. Limerence uses PostHog OAuth, so you do not need to create or paste a personal API key.

Connect PostHog Cloud

1. Open Data Sources and choose New connection.
2. Select PostHog.
3. Keep PostHog Cloud selected and choose Connect with PostHog.
4. Approve access in the browser, then return to Limerence.
5. Choose an approved project, name the connection, and select Test & Connect.

Limerence requests only query:read, event_definition:read, and property_definition:read. The access and refresh tokens are kept in the desktop app's encrypted credential store. Limerence refreshes short-lived access tokens as needed and revokes the refresh token when you delete the data source.

Self-hosted PostHog

Choose Self-hosted, enter the PostHog origin (for example, https://posthog.example.com), and continue with the same OAuth flow. HTTPS is required except for a loopback development host such as http://127.0.0.1. Your PostHog instance must expose its OAuth authorization, token, and revocation endpoints under /oauth.

Troubleshooting

• A required permission was not granted: reconnect and approve all three requested read scopes.
• No project is available: reconnect and select at least one project on the PostHog consent screen.
• Connection test failed: confirm the selected project still exists and the signed-in PostHog user can query it.
• The connection can no longer refresh: edit its name if needed, or delete the connection and connect it again to issue a new OAuth grant.