Skip to main content

PostHog source

The PostHog source connector lets you connect to a PostHog instance and authenticate using a Personal API key.

Overview​

The PostHog source connector lets you sync data from your PostHog workspace into your warehouse for analysis and reporting.

Setup​

Before configuring the connector, gather:

  • PostHog host (your PostHog base URL)
    • Examples:
      • PostHog Cloud: https://app.posthog.com
      • Self-hosted: https://posthog.yourcompany.com
  • Organization ID (the PostHog organization identifier)
  • Personal API key (a PostHog personal API token)

Authentication​

This connector authenticates with:

  • Bearer token: your PostHog Personal API key

During connection validation, the connector calls the PostHog API endpoint GET https://us.posthog.com/api/projects/@current/ to confirm the credentials are valid.

Configuration​

FieldTypeRequiredDescription
hoststring✓Base URL for your PostHog instance. May be provided with or without a scheme. If no scheme is provided, https:// is assumed. Trailing slashes are ignored. Examples: https://app.posthog.com, posthog.yourcompany.com.
organization_idstring✓Your PostHog organization ID.
personal_api_keystring✓A PostHog Personal API key used as a Bearer token for API requests.

Streams​

This connector is still in development and does not yet extract any streams. Connection validation (credential checking) is supported.

Notes​

The PostHog connector currently supports PostHog as a source.

A PostHog Conversions API destination exists in the codebase for credential validation, but loading data is still in development and is not yet available for use.