Advanced Analytica Advanced Analytica: IBOM
← All connectors
PostHog logo

Source connector

PostHog

Set up PostHog as a source and move its data into your chosen destination.

Version 1.1.31 community beta

PostHog

Use this page to set up the PostHog source connector and find reference information.

Prerequisites

  • api_key - get your account’s Private API Key by following steps
  • base_url - defaults to https://app.posthog.com’, but may differ for self-hosted PostHog instances

Setup guide

Step 1: Set up PostHog

  • PostHog Account

Step 2: Set up the PostHog connector in Airbyte

Airbyte Cloud

  1. Log into your Airbyte Cloud account.
  2. Select Sources from the left navigation bar. Then, select +new source in the top-right corner.
  3. On the Set up the source page, enter a name for the PostHog connector. Select PostHog from the Source type dropdown.
  4. Enter your apikey.
  5. Enter your start_date.
  6. Change the default base_url if you use a self-hosted PostHog instance.
  7. Select Set up source.

Airbyte OSS

  1. Open the Airbyte Open Source dashboard.
  2. Enter a name for your source.
  3. Enter your api_key.
  4. Enter your start_date.
  5. Change the default base_url if you use a self-hosted PostHog instance.
  6. Select Set up source.

Supported streams and sync modes

Rate limits

Private GET, POST, PATCH and DELETE endpoints have rate limits. Public POST-only endpoints are not rate limited. Rate limits generally apply when you authenticate with a personal API key.

Different resource types have separate limits.

  • Analytics endpoints have limits of 240/minute and 1200/hour. These include calculating insights, retrieving persons and retrieving session recordings.

  • The HogQL query endpoint (/api/project/:id/query) has a rate limit of 120/hour.

  • All other create, read, update and delete endpoints have limits of 480/minute and 4800/hour.

  • Public POST-only endpoints have no rate limits. These include event capture (/capture) and feature flag evaluation (/decide).

These limits apply to the entire team, meaning all users within your PostHog organisation. For example, a script requesting feature flag metadata might reach the rate limit. A different user’s single persons API request is then also rate limited, even with another personal API key.

Use batch exports for large or regular event exports.

To use the PostHog API beyond these limits, email PostHog at [email protected].

IP allow list

If you use Airbyte Cloud and restrict access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.

Changelog

Expand to review
VersionDatePull RequestSubject
1.1.312026-11-1091639Update dependencies
1.1.302026-11-0390903Require Python 3.11 or newer, retaining support through Python 3.13.
1.1.292026-11-0390691Update dependencies
1.1.282026-10-2790013Update dependencies
1.1.272026-10-2078912Update dependencies
1.1.262026-10-1488960Update to CDK v7 and base image 4.1.1
1.1.252025-02-0153032Update dependencies
1.1.242025-01-2552536Update dependencies
1.1.232025-01-1851856Update dependencies
1.1.222025-01-1151313Update dependencies
1.1.212024-12-2850685Update dependencies
1.1.202024-12-2150280Update dependencies
1.1.192024-12-1449716Update dependencies
1.1.182024-12-1249066Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64
1.1.172024-10-2947724Update dependencies
1.1.162024-10-2847033Update dependencies
1.1.152024-10-1246769Update dependencies
1.1.142024-10-0546421Update dependencies
1.1.132024-09-2846108Update dependencies
1.1.122024-09-2145796Update dependencies
1.1.112024-09-1445570Update dependencies
1.1.102024-09-0745241Update dependencies
1.1.92024-08-3144996Update dependencies
1.1.82024-08-2444658Update dependencies
1.1.72024-08-1744350Update dependencies
1.1.62024-08-1344016Fix events stream pagniator to workaround PostHog API issue #13508
1.1.52024-08-1043488Update dependencies
1.1.42024-08-0343232Update dependencies
1.1.32024-07-2742769Update dependencies
1.1.22024-07-2042151Update dependencies
1.1.12024-07-1341823Update dependencies
1.1.02024-06-2039763Add properties and uuid attributes to persons stream
1.0.02023-12-0428593Fix events.event type
0.1.152023-10-2831265Fix Events stream datetime format
0.1.142023-08-2929947Add optional field to spec: events_time_step
0.1.132023-07-1928461Fixed EventsSimpleRetriever declaration
0.1.122023-06-2827764Update following state breaking changes
0.1.112023-06-0927135Fix custom EventsSimpleRetriever
0.1.102023-04-1524084Increase events streams batch size
0.1.92023-02-1322906Specified date formatting in specification
0.1.82022-11-1118993connector migrated to low-code, added projects,insights streams, added project based slicing for all other streams
0.1.72022-07-2614585Add missing ‘properties’ field to event attributes
0.1.62022-01-208617Update connector fields title/description
0.1.52021-12-249082Remove obsolete session_events and insights streams
0.1.42021-09-146058Support self-hosted posthog instances
0.1.32021-07-204001Incremental streams read only relevant pages
0.1.22021-07-154692Use account information for checking the connection
0.1.12021-07-054539Add AIRBYTE_ENTRYPOINT env variable for kubernetes support
0.1.02021-06-083768Initial Release
Advanced Analytica

Most businesses are sitting on information they can’t use at speed. The people who hold it are busy, and when they leave, the knowledge goes with them. The documents are static, and the processes around them weren’t designed for AI.

Advanced Analytica works with these businesses to turn that information into structured data assets. Once they're integrated, AI systems can govern it, and the business can use it. We bring in the strategy, the specification and the AI skills to rework how the business operates.

MOVE FAST. STAY SAFE.