PostHog

The PostHog node lets your agents capture custom events and query product analytics data.

Connection Setup

PostHog requires two different keys for full functionality:

1. Personal API Key (for connection)

When connecting PostHog via Settings → Integrations, Pipedream authenticates using a Personal API key. This key is used to access the PostHog REST API (fetching organizations, projects, and other account data).

1. Go to PostHog → Settings → Personal API Keys
2. Click Create personal API key
3. Give it a descriptive name (e.g., “Spawnbase”)
4. Select scopes carefully — PostHog personal API keys are scoped by default. You must explicitly grant the permissions Spawnbase needs:
   • organization:read — required to list organizations
   • project:read — required to list projects
   • event:read — required if using analytics query actions
   • event:write — required if using the Capture Event action
5. Copy the key — it starts with phx_
6. Use this key when connecting PostHog in Spawnbase

Note

If you skip scopes or leave them at defaults, the connection will succeed but individual fields may fail to load options with a generic error. 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 when the node tries to load configuration options like organizations and projects.

2. Project API Key (for event capture)

Some PostHog actions (like Capture Event) require a Project API key as an input field. This is separate from the connection key above.

1. Go to PostHog → Settings → Project API Key
2. Copy the project API key — it starts with phc_
3. Paste it into the projectApiKey field in the node configuration

Troubleshooting

See Node Configuration Troubleshooting for common issues like empty dropdowns, failed option loading, and connection errors.