Skip to main content
Open Connectors → Connect → PostHog as an Administrator. Choose the region of your PostHog account, give the connection a label, and review the requested permissions before authorizing in the browser. Return to Nuphos and select the projects to expose. Do not paste a public ingestion key as an OAuth credential.

​
Projects and permissions

The connection’s details let you review granted permissions and edit selected projects. At least one project must remain selected. Reducing a local project selection is different from expanding provider OAuth scopes; reconnect when a new grant is needed or the connection reports Reconnect required. Use only the granted scopes. An agent can run HogQL for events, funnels, retention or active users and read supported analytics objects. Write-capable scopes can allow changes to objects such as feature flags; review the proposed change and its exact project before authorizing it.

​
Verify

Select the binding in a conversation and ask for the available projects and a small, bounded query on one of them. Check the project ID, time range and event meaning before treating a count as a product metric. Authentication does not make data from an unselected project available.

​
Troubleshooting and removal

Check region, selected projects and scopes after a permission error. Reauthorize through the connection’s reconnect action when necessary; never solve it by pasting a token into chat. Remove the binding in Nuphos and revoke the grant at PostHog when access should end. Historical query results in chats remain. See PostHog API scopes for provider permission definitions.