Last updated:

|Edit this page

Send event data from PostHog into User emails will also be sent if available and customers will be created in

Note: We currently have an open issue with our plugin which is impacting some functionality.


Using this requires either PostHog Cloud with the data pipeline add-on, or a self-hosted PostHog instance running version 1.30.0 or later.

Self-hosting and not running 1.30.0? Find out how to update your self-hosted PostHog deployment.

You'll also need access to the relevant account.


  1. In PostHog, click the "Data pipeline" tab in the left sidebar.
  2. Search for '' and select the destination, press Install.
  3. Add your site ID and token at the configuration step.
  4. Enable the destination and watch your 'People' list get populated in!


OptionDescription Site ID
Type: string
Required: True
Provided during setup. API Key
Type: string
Required: True
Provided during setup.
Tracking Endpoint
Type: choice
Required: False
Use the EU variant if your account is based in the EU region.
Identify by email
Type: choice
Required: False
If enabled, the plugin will identify users by email instead of ID, whenever an email is available.
Filtering of Anonymous Users
Type: choice
Required: False pricing is based on the number of customers. This is an option to only send events from users that have been identified. Take into consideration that merging after identification won't work (as those previously anonymous events won't be there).
PostHog Event Allowlist
Type: string
Required: False
If this is set, only the specified events (comma-separated) will be sent to

How do I match persons in PostHog with customers in

We assume that you use the same ID to identify users in as you use as distinct_id or in posthog.identify().

How do I set properties on a customer via PostHog?

PostHog will send any property inside the $set: {} property to In the example below, email and userProperty will be set on the customer

event_property: 'this will not get sent',
$set: {
email: '',
userProperty: 'value'


Is the source code for this destination available?

PostHog is open-source and so are all the destination on the platform. The source code is available on GitHub.

Who created this destination?

We'd like to thank PostHog team members Yakko Majuri and Marius Andra, Michael Matloka and community members Angela Purcell, Conrad Kurth and Alberto S for creating this.

Who maintains this?

This is maintained by PostHog. If you have issues with it not functioning as intended, please let us know!

What if I have feedback on this destination?

We love feature requests and feedback. Please tell us what you think..

What if my question isn't answered above?

We love answering questions. Ask us anything via our community forum.


Was this page useful?

Next article


Connect PostHog to Engage , a marketing automation platform, and sends data to Engage for use in segmentation, targeting and automation. Specifically, it only exports your Custom and $identify events to Engage. Extra event properties and metadata are also processed and sent to Engage. The example above, using the PostHog browser JS SDK, appends extra properties to the identify event. These extra properties are also sent to Engage. You'll also need access to a Engage account, obviously…

Read next article