PostHog Integration

The PostHog node lets your agents capture custom events, query analytics with HogQL, and manage insights and cohorts.

Connection Setup

PostHog requires two different keys for full functionality:

Personal API Key (for connection)

When connecting PostHog via Settings → Integrations, Spawnbase authenticates using a Personal API key (phx_...).

1. Go to PostHog → Settings → Personal API Keys
2. Click Create personal API key
3. Grant scopes: organization:read, project:read, event:read, event:write
4. Use this key when connecting PostHog in Spawnbase

Note

If you skip scopes or leave them at defaults, the connection will succeed but fields may fail to load options. When in doubt, grant all read scopes.

Caution

Do not use a Project API key (phc_...) for the connection. Project API keys are for event ingestion only and will fail with a 401 error.

Project API Key (for event capture)

The Capture Event action requires a separate Project API key as an input field.

1. Go to PostHog → Settings → Project API Key
2. Copy the key (phc_...) and paste it into the projectApiKey field in the node configuration

Available Tools

Querying & Analytics

Tool	Description
query-run	Run trends, funnels, retention, lifecycle, paths, and stickiness queries
query-generate-hogql-from-question	Generate and run HogQL queries from natural language
query-trends	Query trend data for events over time
query-funnel	Analyze conversion funnels
query-retention	Analyze user retention
query-lifecycle	Query user lifecycle stages
query-paths	Analyze user navigation paths
entity-search	Search insights, dashboards, experiments, flags, cohorts, and more by name

Insights & Dashboards

Tool	Description
insight-create-from-query	Create a new insight from a query
insight-get	Get a specific insight by ID
insight-update	Update an existing insight
insights-get-all	List all insights in the project
dashboard-create	Create a new dashboard
dashboard-get	Get a dashboard with all tiles
dashboards-get-all	List all dashboards

Feature Flags & Experiments

Tool	Description
create-feature-flag	Create a feature flag with targeting rules
update-feature-flag	Update flag rollout, filters, or variants
feature-flag-get-all	List all feature flags
experiment-create	Create an A/B experiment
experiment-results-get	Get experiment results

Persons & Cohorts

Tool	Description
persons-list	List persons with filters
persons-retrieve	Get a specific person’s details
cohorts-create	Create a static or dynamic cohort
cohorts-list	List all cohorts

Alerts & Monitoring

Tool	Description
alert-create	Create threshold or anomaly detection alerts on insights
alert-simulate	Preview how a detector would perform on historical data
alerts-list	List all alerts

Surveys & Other

Tool	Description
survey-create	Create a survey
surveys-get-all	List all surveys
annotation-create	Mark deployments or changes on charts
activity-logs-list	View who changed what and when
docs-search	Search PostHog documentation

Tips

• Capture Event uses the Project API key (phc_...), not the Personal API key — this trips up most users.
• Create Query accepts HogQL — useful for flexible analytics queries your agent can construct dynamically.
• Most read actions require organization and project_id fields — these load dynamically from your connected account.

MCP Server

Server URL	https://mcp.posthog.com/mcp
Transport	Streamable HTTP
Docs	PostHog MCP

Use Cases

• How to Automate Your PostHog Weekly Review — pull AARRR metrics, spot what changed, post an actionable digest to Slack

Troubleshooting

See Node Configuration Troubleshooting for common issues like empty dropdowns and connection errors.