Engage Connector

Last updated:

What does the Engage Connector do?

This app connects PostHog to Engage, a marketing automation platform, and sends data to Engage for use in segmentation, targeting and automation.

Specifically, this app only exports your Custom and $identify events to Engage.

Extra event properties and metadata are also processed and sent to Engage.

posthog.identify(
'[user unique id]', // distinct_id, required
{ userProperty: 'value1' }, // $set, optional
{ anotherUserProperty: 'value2' } // $set_once, optional
);

The example above, using the PostHog JS SDK, appends extra properties to the identify event. These extra properties are also sent to Engage.

What are the requirements for this app?

The Engage Connector requires either PostHog Cloud, or a self-hosted PostHog instance running version 1.30.0 or later.

Not running 1.30.0? Find out how to update your self-hosted PostHog deployment!

You'll also need access to a Engage account, obviously.

How do I install the Engage Connector?

To install this app, you will need your Engage secret key and public key to send data to PostHog. These are available on the 'Settings' page of your Engage dashboard, under the 'Account' > 'API' Keys section.

Once you have made a note of your keys, log in to your PostHog instance and follow the steps below.

  1. Visit the 'Apps' page in your instance of PostHog.
  2. Search for 'Engage' and select the app, press Install.
  3. Enter configuration by selecting the blue gear icon.
  4. Enter the API information as requested, select save.

Now, as soon as the app is enabled, PostHog will start sending your events to Engage in real-time.

Configuration

OptionDescription
public_key
Type: string
Required: True
Get your public key from your Engage dashboard (Settings -> Account)
secret
Type: string
Required: True
Get your secret key from your Engage dashboard (Settings -> Account)

Is the source code for this app available?

PostHog is open-source and so are all apps on the platform. The source code for the Engage Connector is available on GitHub.

Who created this app?

We'd like to thank PostHog community members Francis Onyishi and Opeyemi Obembe for creating the Engage Connector. Thank you!

Who maintains this app?

This app is maintained by the community. If you have issues with the app not functioning as intended, please raise a bug report on the repo to let us know!

What if I have feedback on this app?

We love feedback! Please create an issue to tell us what you think.

What if my question isn't answered above?

We love answering questions too! Ask us anything via our FAQ page.

You can join the PostHog Community Slack group to ask more questions, or get advice on developing your own PostHog apps.

Questions?

Was this page useful?

Next article

GCP Pub/Sub Connector

What does the Google Cloud Pub/Sub Connector do? This app sends events from PostHog to a Google Cloud Pub/Sub topic when they are ingested. It's used by teams such as Vendasta . What are the requirements for this app? The Pub/Sub Connector requires either PostHog Cloud, or a self-hosted PostHog instance running version 1.30.0 or later. Not running 1.30.0? Find out how to update your self-hosted PostHog deployment ! You'll also need a Google Cloud Pub/Sub account to connect to. How do I…

Read next article