Engage Destination

Engage Messaging quick info

Engage Messaging is in beta, and accepts Identify, and Track calls. If you reference it in the Integrations object, call it “Engage Messaging”.

Engage Messaging

Engage Messaging helps businesses send personalised messages to customers based on customer traits and actions.

This destination is maintained by Engage Messaging. For any issues with the destination, contact the Engage Messaging Support team.

Getting Started

  1. From the Destinations catalog page in the Segment App, click Add Destination.
  2. Search for “Engage Messaging” in the Destinations Catalog, after selecting it, choose the Source that will send data to Engage Messaging.
  3. Go to your Engage dashboard, find and copy your “Public API key”.
  4. Enter the API Key in the destination settings in Segment.

Supported methods

Engage Messaging supports the following methods, as specified in the Segment Spec.


Send Identify calls to identify the user profile and traits on Engage. For example:

analytics.identify('userId123', {
  email: 'john.doe@example.com'

If the user already exists on Engage, identify can also be used to update the user traits. Segment sends Identify calls to Engage Messaging as an identify event.


Send Track calls to track user events and actions. For example:

analytics.track('Login Button Clicked')

Segment sends Track calls to Engage Messaging as a track event.


You can send computed traits and audiences generated using Segment Personas to this destination as a user property. To learn more about Personas, contact us for a demo.

For user-property destinations, an identify call is sent to the destination for each user being added and removed. The property name is the snake_cased version of the audience name, with a true/false value to indicate membership. For example, when a user first completes an order in the last 30 days, Personas sends an Identify call with the property order_completed_last_30days: true. When the user no longer satisfies this condition (for example, it’s been more than 30 days since their last order), Personas sets that value to false.

When you first create an audience, Personas sends an Identify call for every user in that audience. Later audience syncs only send updates for users whose membership has changed since the last sync.

Supported Sources and Connection Modes

Segment offers an optional Device-based Connection Mode for Mobile data going to Engage Messaging, so that you can use Engage Messaging features that collect data directly from the mobile device. To do this, you must package the Segment-Engage Messaging mobile SDK with the Segment mobile library.


Segment lets you change these destination settings from the Segment app without having to touch any code.

Setting Description
string. Your public API key is available in Settings -> Account on your Engage dashboard
List ID
array, defaults to .

List ID you want to subscribe the user to. Opt-in confirmations are not sent for these even if enabled for the lists

This page was last modified: 15 Sep 2021

Get started with Segment

Segment is the easiest way to integrate your websites & mobile apps data to over 300 analytics and growth tools.
Create free account