> ## Documentation Index
> Fetch the complete documentation index at: https://docs.userpilot.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Heap Integration

> Integrating Heap with Userpilot helps you deeply analyze Userpilot experiences' performance, health, and impact on your users.

### Common use cases

* **Find where experiences lose people** - Use the `Userpilot Experience (step)` and `(dismissed)` events to pinpoint the exact step where users drop out of a flow, then test and adjust it.
* **Segment on in-app behavior** - Create Heap segments from Userpilot events (e.g. users who dismissed a tour, submitted a form, or gave a low NPS score) for deeper analysis or downstream targeting.
* **Close the loop on feedback** - Correlate `Userpilot NPS (score)` and feedback events with real product usage to understand what separates promoters from detractors.

### Heap as a data source

Currently, Userpilot delivers data to Heap but not the other way around. However, it is within our roadmap to make this a two-way integration.

### Heap as a data destination

You can send Userpilot events to Heap if you choose Heap as a data destination. These events can be used in a variety of use cases and for decision-making depending on the information delivered.

### Integration requirements

* A Heap account and a Userpilot account, both fully installed on every page of your application. (Please refer to [this guide](https://developers.heap.io/docs/web) for more information on how to install Heap).
* Heap integration can be enabled with a single click. Simply visit the integrations page and hit the Heap integration box.

<img src="https://mintcdn.com/userpilot/pnl240TU6qsZayfO/images/Screen-Recording-2026-07-22-at-10.45.40-PM.gif?s=69829e92be8c7323dae2e884595e0565" className="dark:hidden" width="1330" height="692" data-path="images/Screen-Recording-2026-07-22-at-10.45.40-PM.gif" />

<img src="https://mintcdn.com/userpilot/pnl240TU6qsZayfO/images/Screen-Recording-2026-07-22-at-10.45.40-PM-1.gif?s=862820182126ab78add7626647d7bbb4" className="hidden dark:block" width="1330" height="692" data-path="images/Screen-Recording-2026-07-22-at-10.45.40-PM-1.gif" />

### How this integration works

Following the integration of Heap and Userpilot, events from Userpilot will be immediately synced with your Heap account.

### What data do we send?

Events data is sent by Userpilot to Heap. Events are interactions between Userpilot content and the end user, such as:

* Experiences
  * Userpilot Experience (started)
  * Userpilot Experience (step)
  * Userpilot Experience (dismissed)
  * Userpilot Experience (completed)
* Checklists
  * Userpilot Checklist (started)
  * Userpilot Checklist (task completed)
  * Userpilot Checklist (completed)
  * Userpilot Checklist (dismissed)
* NPS events
  * Userpilot NPS (ask later)
  * Userpilot NPS (score)
  * Userpilot NPS (feedback)
* Form Submissions.

These events will be shown on your Heap Definitions dashboard in the Events section.

<Note>
  Labeled events and Button tracked events are not sent via Native Heap integration
</Note>

<img src="https://mintcdn.com/userpilot/x9xXqXi1_IGle4ai/integrations/assets/images/file-Uy7uoux93X.png?fit=max&auto=format&n=x9xXqXi1_IGle4ai&q=85&s=213778a5e1b3e158bbf1051a9a7bea67" alt="" width="1366" height="687" data-path="integrations/assets/images/file-Uy7uoux93X.png" />

<Frame>
  [For any questions or concerns please reach out to **support@userpilot.com**](mailto:support@userpilot.com)
</Frame>