Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.chartcastr.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Use PostHog as a data source for Chartcastr. Connect your PostHog project with a Personal API Key and Chartcastr will pull active user metrics, growth accounting data, and event analytics to generate charts delivered automatically to Slack or email. Chartcastr connects with read-only access to your PostHog project — it needs the query:read and project:read API key scopes.

​
Setup

1

Create a PostHog Personal API Key

In PostHog, go to Settings → Personal API Keys (direct link) and create a new key. Grant it the query:read and project:read scopes. Copy the key — you’ll need it in the next step.
Use a Personal API Key (starts with phx_), not the Project API Key. The Project API Key only works for event capture, not for reading analytics data.
2

Find your Project ID

In PostHog, go to Settings → Project (direct link) and copy your Project ID (a numeric value). You can also find it in the URL: https://us.posthog.com/project/<PROJECT_ID>/.
3

Connect in Chartcastr

In Chartcastr, go to New Connection and select PostHog as a source. Enter your Personal API Key, Project ID, and host URL. Click Validate to test the connection.
Host URL: Use https://us.posthog.com for US Cloud or https://eu.posthog.com for EU Cloud. Self-hosted users should enter their own PostHog instance URL.
4

Select a metric

Choose which metric type you want to track. Each metric becomes its own source. You can add multiple sources to send different charts on different schedules.
5

Create a connection

Pick or add a destination (Slack channel or email), set the delivery frequency, and optionally enable AI summaries.

​
Available Metrics

Chartcastr supports 13 pre-built PostHog metrics across four categories.

Active Users

DAU, WAU, MAU, and combined DAU/WAU/MAU charts for engagement tracking.

Growth Accounting

New, retained, resurrected, and dormant user lifecycle stages.

Events

Total event count and unique event users per day.

Pageviews

Total pageviews and unique pageview users per day.

View all available charts

See the full list of PostHog metrics with chart types and descriptions.

​
API Key Scopes

Chartcastr requires the query:read and project:read scopes:
  • query:read — Read-only access to PostHog’s Query API for fetching analytics data
  • project:read — Read-only access to project info (needed to validate the connection)
No write access is needed. You can optionally restrict the API key to a specific project for additional security.

​
Rate Limits

PostHog’s Query API has rate limits of 120–2,400 requests/hour depending on your PostHog plan, with a maximum of 3 concurrent queries per project. Chartcastr respects these limits and batches queries efficiently.

​
Next Steps

Slack destination

Deliver PostHog charts to your Slack channels with AI summaries in the thread.

Email destination

Schedule PostHog reports to any inbox or distribution list.