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
- Log into your Airbyte Cloud account.
- Select Sources from the left navigation bar. Then, select +new source in the top-right corner.
- On the Set up the source page, enter a name for the PostHog connector. Select PostHog from the Source type dropdown.
- Enter your
apikey. - Enter your
start_date. - Change the default
base_urlif you use a self-hosted PostHog instance. - Select Set up source.
Airbyte OSS
- Open the Airbyte Open Source dashboard.
- Enter a name for your source.
- Enter your
api_key. - Enter your
start_date. - Change the default
base_urlif you use a self-hosted PostHog instance. - Select Set up source.
Supported streams and sync modes
- Projects
- Annotations
- Cohorts
- Events (Incremental)
- FeatureFlags
- Insights
- Persons
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/minuteand1200/hour. These include calculating insights, retrieving persons and retrieving session recordings. -
The HogQL query endpoint (
/api/project/:id/query) has a rate limit of120/hour. -
All other create, read, update and delete endpoints have limits of
480/minuteand4800/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
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 1.1.31 | 2026-11-10 | 91639 | Update dependencies |
| 1.1.30 | 2026-11-03 | 90903 | Require Python 3.11 or newer, retaining support through Python 3.13. |
| 1.1.29 | 2026-11-03 | 90691 | Update dependencies |
| 1.1.28 | 2026-10-27 | 90013 | Update dependencies |
| 1.1.27 | 2026-10-20 | 78912 | Update dependencies |
| 1.1.26 | 2026-10-14 | 88960 | Update to CDK v7 and base image 4.1.1 |
| 1.1.25 | 2025-02-01 | 53032 | Update dependencies |
| 1.1.24 | 2025-01-25 | 52536 | Update dependencies |
| 1.1.23 | 2025-01-18 | 51856 | Update dependencies |
| 1.1.22 | 2025-01-11 | 51313 | Update dependencies |
| 1.1.21 | 2024-12-28 | 50685 | Update dependencies |
| 1.1.20 | 2024-12-21 | 50280 | Update dependencies |
| 1.1.19 | 2024-12-14 | 49716 | Update dependencies |
| 1.1.18 | 2024-12-12 | 49066 | Starting 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.17 | 2024-10-29 | 47724 | Update dependencies |
| 1.1.16 | 2024-10-28 | 47033 | Update dependencies |
| 1.1.15 | 2024-10-12 | 46769 | Update dependencies |
| 1.1.14 | 2024-10-05 | 46421 | Update dependencies |
| 1.1.13 | 2024-09-28 | 46108 | Update dependencies |
| 1.1.12 | 2024-09-21 | 45796 | Update dependencies |
| 1.1.11 | 2024-09-14 | 45570 | Update dependencies |
| 1.1.10 | 2024-09-07 | 45241 | Update dependencies |
| 1.1.9 | 2024-08-31 | 44996 | Update dependencies |
| 1.1.8 | 2024-08-24 | 44658 | Update dependencies |
| 1.1.7 | 2024-08-17 | 44350 | Update dependencies |
| 1.1.6 | 2024-08-13 | 44016 | Fix events stream pagniator to workaround PostHog API issue #13508 |
| 1.1.5 | 2024-08-10 | 43488 | Update dependencies |
| 1.1.4 | 2024-08-03 | 43232 | Update dependencies |
| 1.1.3 | 2024-07-27 | 42769 | Update dependencies |
| 1.1.2 | 2024-07-20 | 42151 | Update dependencies |
| 1.1.1 | 2024-07-13 | 41823 | Update dependencies |
| 1.1.0 | 2024-06-20 | 39763 | Add properties and uuid attributes to persons stream |
| 1.0.0 | 2023-12-04 | 28593 | Fix events.event type |
| 0.1.15 | 2023-10-28 | 31265 | Fix Events stream datetime format |
| 0.1.14 | 2023-08-29 | 29947 | Add optional field to spec: events_time_step |
| 0.1.13 | 2023-07-19 | 28461 | Fixed EventsSimpleRetriever declaration |
| 0.1.12 | 2023-06-28 | 27764 | Update following state breaking changes |
| 0.1.11 | 2023-06-09 | 27135 | Fix custom EventsSimpleRetriever |
| 0.1.10 | 2023-04-15 | 24084 | Increase events streams batch size |
| 0.1.9 | 2023-02-13 | 22906 | Specified date formatting in specification |
| 0.1.8 | 2022-11-11 | 18993 | connector migrated to low-code, added projects,insights streams, added project based slicing for all other streams |
| 0.1.7 | 2022-07-26 | 14585 | Add missing ‘properties’ field to event attributes |
| 0.1.6 | 2022-01-20 | 8617 | Update connector fields title/description |
| 0.1.5 | 2021-12-24 | 9082 | Remove obsolete session_events and insights streams |
| 0.1.4 | 2021-09-14 | 6058 | Support self-hosted posthog instances |
| 0.1.3 | 2021-07-20 | 4001 | Incremental streams read only relevant pages |
| 0.1.2 | 2021-07-15 | 4692 | Use account information for checking the connection |
| 0.1.1 | 2021-07-05 | 4539 | Add AIRBYTE_ENTRYPOINT env variable for kubernetes support |
| 0.1.0 | 2021-06-08 | 3768 | Initial Release |