> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nuphos.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# PostHog

> Authorize projects and scopes for analytics queries and selected changes.

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](https://posthog.com/docs/api/scopes) for provider
permission definitions.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.