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.

What You Can Send

Part	What It Does	Where It Shows in HubSpot
Page-view tracking	Adds HubSpot’s tracking code to microapps you choose, so visits count as web traffic.	Traffic analytics, and page views on known contacts
Session data	Sends each session’s details to the matching contact as a custom event.	The contact record, in near real time

Set up page-view tracking first. Session data is an optional second step that builds on it.

Before You Start

• In Tiled — an admin account that can manage integrations.

• In HubSpot — permission to edit tracking settings, and to create a private app or custom events if you’ll send session data. Custom events may require a HubSpot plan that includes them.

• Your HubSpot tracking code — from HubSpot’s tracking code settings.

• Recipient emails — session data can only be matched to a contact when Tiled knows the viewer’s email. See Which Sessions Reach a Contact below.

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.

Note: Traffic is reported for each microapp as a whole, not for individual pages inside it. For page-by-page detail, use Pathway Analytics in Tiled.

Which sessions reach a contact

Session data can only be matched to a HubSpot contact when Tiled knows who the viewer is. That happens when the viewer opens:

• A Direct Share sent to their email.

• A link with email gating, where they enter their email to view.

• A link restricted to verified emails or domains.

Pro Tip: For microapps you want tracked in HubSpot, share with Direct Share or turn on email gating. Anonymous Public link sessions still count as traffic, but can’t be added to a contact.

Reporting on Microapp Traffic in HubSpot

To see microapp visits by contact, build a custom report in HubSpot:

1. Go to Reports → Create custom report → Custom Report Builder, — and select the Contacts and Web activities data sources.

2. Filter Page views URL to contain s.tiled.co, — and add a date range if you like.

3. Add URL, Timestamp, and Count of page views — to the report.

Privacy & Data Considerations

This integration sends personal data, including email addresses and engagement behavior, to HubSpot. Before you turn it on:

• Make sure you have a legal basis to send recipient engagement data to your CRM, and that your HubSpot data processing terms cover it.

• Once data reaches HubSpot, HubSpot’s retention and privacy policies apply to it.

• If you need a consent banner for viewers, turn on Require user consent in the library’s Privacy Management settings.

• If you’re unsure, check with your legal or privacy team.

Managing and 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.

• Pause — turn off the connection’s Status toggle in Settings → Integrations.

• Stop one microapp — turn off the HubSpot integration in that microapp’s settings and republish.

• Change how data is sent — open the connection’s settings, update Send via or the token or URL, and select Test connection again.

Try It Yourself: Turn on the integration for a test microapp, send yourself a Direct Share, and view a few pages. Then open your own contact record in HubSpot and look for the session. It confirms the whole path before you roll it out.

Troubleshooting

Problem	Check
No traffic in HubSpot	s.tiled.co is in HubSpot’s Additional site domains, the microapp’s HubSpot toggle is on, and the microapp was republished afterward.
Traffic appears, but no contact activity	Automatically send session data is on, Test connection succeeds, and the viewer’s email was known (Direct Share, email gating, or verified email).
Test connection fails	The token or webhook URL was copied in full, and the private app has all three scopes.
Webhook events don’t attach to contacts	The event’s Email property is mapped to the contact Email property under Custom matching ID.

Common Questions

Question	Answer
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.

Related Articles

• Using the Share Form — Email gating and other link options.

• Restricting Share Links to Verified Emails — Collecting verified viewer emails.

• Direct Share Links — Sharing with a specific person.

• Library Settings: General — Privacy Management and the consent banner.

• Engagement: Pathway Analytics — Page-by-page engagement in Tiled.

• Slack Integration — Engagement notifications in Slack.