How to Connect Tiled to HubSpot and Send Engagement Data

Overview

Once connected, Tiled can dispatch session data from microapp interactions directly to your HubSpot account. This allows your sales and marketing teams to act on real-time engagement signals without manually exporting data.

You control which microapps send data to HubSpot and how Tiled session fields map to your HubSpot properties.

Prerequisites

Library Administrator access in Tiled.
An active HubSpot account with permission to authorize third-party integrations.

Setup

Step 1: Connect Your HubSpot Account

From your Tiled Library, navigate to Settings > Integrations.
Locate the HubSpot section and click Connect.
Sign in with your HubSpot credentials and authorize the connection when prompted.
Once authorized, the integration status will show as Active.

Step 2: Configure Session Dispatch

Within the HubSpot integration settings, open the Session Dispatch configuration.
Select which microapps (or microapp categories) should send session data to HubSpot.
Map Tiled session fields to your HubSpot contact or engagement properties.
Click Save. Session data will begin dispatching for new sessions recorded after the configuration is saved.

Note: Only microapps you specifically configure will dispatch data to HubSpot. Sessions from unconfigured microapps are not transmitted.

Data Sent to HubSpot

The following session fields are available to map to your HubSpot properties:

Tiled Field	Description
Recipient Email	Used to match or create a HubSpot contact record. Requires an email address to have been collected at share or session level.
Session Timestamp	The start time of the microapp engagement session.
Microapp Name	The name of the microapp associated with the session.
Session Duration	Total time the recipient spent in the session.
Page / Screen Views	Number of pages or states visited during the session.

Privacy & Data Considerations

This integration sends personal data — including email addresses and behavioral engagement data — to HubSpot. Before enabling the integration, please review the following:

Data is transmitted over encrypted channels.
Once session data is dispatched to HubSpot, it is governed by HubSpot's own data retention and privacy policies.
You are responsible for ensuring you have the appropriate legal basis to send recipient engagement data to your CRM, and that your HubSpot account's data processing terms cover this use case.
If you have questions about data privacy obligations related to this integration, consult your organization's legal or privacy team.

Monitoring the Integration

If a session dispatch fails, the error will surface in the integration health dashboard within your HubSpot integration settings. Review this periodically to confirm data is flowing as expected.

Common Questions

Does the integration send data from all of my microapps automatically?
No — only microapps you configure for session dispatch will send data to HubSpot. You control the scope during setup.

What if a viewer didn't provide their email address?
Recipient email is required to match or create a contact record in HubSpot. Sessions without a collected email address may not dispatch correctly. Consider enabling the email requirement on share links for microapps you plan to connect. See the related article below.

When does data start appearing in HubSpot after I save the configuration?
Session dispatch begins for sessions recorded after you save your configuration. Previously recorded sessions are not retroactively dispatched.

Can I disconnect the integration?
Yes — navigate to Settings > Integrations > HubSpot and disconnect from there. Dispatching will stop for all microapps immediately.