About the stream

This activity stream brings Journey data, email activity, and more into Heap.

You can also trigger Journeys using Heap events. Learn more here

How to enable the stream

In Settings go to "Activity Streams", then "Heap":


Click "Connect to Heap". You will then be asked for your Heap Environment ID which can be found in Heap's settings under the "Projects" tab:


Once connected, you'll receive an email from us with next steps.  

What activities are streamed to Heap?


  • Email sent
  • Email opened
  • Email clicked
  • Email replied
  • Email unsubscribed
  • Email bounced
  • Email deferred
  • Email reported spam
  • Transactional email sent
  • Transactional email opened
  • Transactional email clicked
  • Transactional email replied
  • Transactional email unsubscribed
  • Transactional email bounced
  • Transactional email deferred
  • Transactional email reported spam


  • Headsup shown
  • Headsup opened
  • Headsup responded
  • Headsup dismissed


  • Postcard sent


  • SMS sent

Lists and Segments

  • Added to list
  • Removed from list
  • Entered smart segment
  • Left smart segment


  • Entered journey
  • Ejected from journey


  • Converted

How do I define an activity in Heap?

In Heap (which refers to activities as "Events"), go to the Events tab, and then follow the steps below:


If you wish to do so, you can then filter by any of the following properties:

  • Actor Id: identifier for the person or thing performing the activity. Currently supports contacts only.
  • Actor Type: type of actor performing the activity. Currently supports contacts only.
  • Journey Id: ID of the Journey within which the activity took place.
  • Journey Name: name of the Journey within which the activity took place.
  • Journey Touches to Date: number of times the actor has been communicated with.
  • Shape Id: ID of the Journey shape within which the activity took place.
  • Object Id: identifier for the object on which the activity is being performed.
  • Object Name: name of the object on which the activity is being performed.
  • Object Type: type of object being acted on, for example an email or Journey.
  • Is Touch: whether or not the object is a communication.
  • URL: optional URL associated with the activity. Currently supports email only.
  • Goal Id: ID of the Insights goal within which the activity took place.
  • Goal Name: name of the Insights goal within which the activity took place.
  • Ingest time: time the activity was ingested.

For example, you could define an event based on who opened a specific email by filtering on the "Object Name" property, as demonstrated below: 


You could use this same approach to define an event for when a contact is added to a specific list:


If you'd like to create an event based on a specific Journey, filter on the "Journey Name" property. For example, here's how you could define an event based on who entered a specific Journey:


You can then graph these events in Heap, or use them as the basis of funnels or segments.  

Example Use Cases

Below are some example use cases that utilize Heap's funnel feature. By selecting "Group By" and then selecting a relevant property, Heap allows you to compare the performance of the funnel across a series of objects (for example, emails or Journeys).

Which journeys have the biggest impact on paid conversions?

This funnel:


Will produce the following output:


What email content has the biggest impact on paid conversions?

This criteria:


Will produce this funnel:


Which initial UTM sources drive the most new leads? 

This criteria:


Will produce this funnel:


Have more questions? Submit a request