Skip to content
English
Submit a request
  • There are no suggestions because the search field is empty.

HubSpot Integration

Integrations at Tiled make it easy to connect different business systems and applications, enabling you to continue having all necessary information in one place, making your business processes more efficient and less painful. With our HubSpot integration engagement data is used to monitor the traffic of your microapps within Hubspot analytics.

Jump to Hubspot FAQ's

Before configuring the HubSpot integration in your Tiled account, you must do the following in HubSpot:

  • Add the Tiled share link domain in the Advanced Tracking section of Hubspot. 
  • Copy your HubSpot ID. (Note: To find the ID, click your account name in the upper right-hand corner of your HubSpot account. In the dropdown menu, under your account name, you can find the unique Hub ID.)
    Hubspot

Add the Hubspot Integration

  1. Navigate to Settings in the Library Navigation bar.
  2. Scroll down to Integrations.
  3. Click Browse Apps.
  4. Select Hubspot.
  5. Add a Name, Description and Hubspot Tracking code for this integration.
  6. Click Connect.

Activate Hubspot Tracking in the Microapp Settings

Once a Hubspot Integration has been added to your library, you will need to activate the tracking code in the microapp settings to begin tracking your microapp with Hubspot.

  1. Edit a microapp.
  2. Navigate to the Microapp Settings (the gear icon at the top of the builder).
  3. Select Integrations.
  4. Toggle the Hubspot Integration on.
  5. Publish your microapp.

Add s.tiled.co to Advanced Tracking in Hubspot

  1. In your HubSpot Account, go to Settings
  2. Navigate to Tracking & Analytics dropdown > Tracking Code.
  3. On the Reports & Analytics Tracking page, select the Advanced Tracking tab.
    1. Within the Additional site domains section, select +Add domain.
    2. Add s.tiled.co .

Create a Custom Report for Microapp Traffic

  1. In your HubSpot Account, select the Reports tab >> Reports
  2. Select Create custom report (top right)
  3. What do you want to report on? Select Custom Report Builder box
  4. Check box the Contacts and Web activities objects (at minimum), click Next.
  5. Now in the builder, from the Web activities data source, add URL and Timestamp properties as filters.
  6. In the Filters tab, update the filters to display Page views URL contains any of “s.tiled.co” and if you’d like a date range, Page views Timestamp [update to your preferred time frame].
  7. In the Configure tab, drag and drop the Web activities URL, Timestamp, and Count of page views properties in the axis/breakdown fields to display your data as desired. 

 

Automatically Send Session Data to HubSpot

Unlike the HubSpot tracking code integration — which records high-level page view activity — this feature automatically pushes detailed session data from Tiled directly to a specific HubSpot contact record. This allows you to tie microapp engagement to individual contacts in your CRM.

In HubSpot:

  1. Go to Development > Legacy Apps and click Create legacy app, then select Private.

  2. Enter a Name (e.g., "Tiled Microapp Session") and optional Description for your app.

  3. Go to the Scopes tab and add the following three scopes:

    • analytics.behavioral_events.send

    • behavioral_events.event_definitions.read_write

    • business-intelligence

  4. Skip the Webhooks tab and click Create app.

  5. On the app page, click the Auth tab and copy the Access token.

In Tiled:

  1. In the HubSpot integration settings, toggle on Automatically send session data.

  2. Under Send via, select HubSpot API.

  3. Paste the Access token into the API Token field.

  4. Click Test connection. When you see Connection successful!, Save the integration.

Hubspot FAQ's

What does it mean to connect an application to Tiled?

Connecting an application to Tiled means you have provided Tiled with the information needed to create the integration between your business application and Tiled at the account settings level.

What does it mean to enable an integration in Tiled?

Enabling an integration means you have turned an integration on at the microapp settings level.

What do I need to connect HubSpot to Tiled?

You will need your HubSpot ID to connect your HubSpot account to Tiled. 

Can I connect more than one HubSpot account to Tiled?

Yes, Admins can have more than one HubSpot account connected at the account level. 

Can I choose which HubSpot account is enabled for consuming microapp traffic information?

Yes, you can choose which microapps have the HubSpot account tracking enabled. 

Where can I enable the HubSpot integration for a microapp?

You can enable the HubSpot integration for a microapp from the 'Microapp Settings' modal in the builder.

Can I enable more than one HubSpot integration for a microapp?

No, you cannot enable more than one HubSpot integration at the microapp level. This is a limitation of HubSpot.

Why would I want to connect more than one HubSpot account to Tiled?

Some companies have multiple HubSpot accounts depending on how the company operates. There may be a HubSpot account for US offices and Europe offices. Tiled allows you to connect to each of these.

Where can I expect to see microapp data in HubSpot?

You can expect to see microapp traffic details on the Traffic Analytics pages and the Contact Record.

What type of Tiled information can I expect to see in HubSpot?

As microapp sessions are occurring, you can expect to see the following Tiled microapp details:

    • Microapp name
    • Total # of sessions per microapp
    • Unique share link
    • Session date

As microapp sessions are occurring, you can expect to see the following Tiled microapp details:

      • Sessions
      • Contact conversion rate
      • New contacts
      • Customer conversation rate
      • Customers
      • Bounce rate
      • New visitor sessions
      • New session %
      • Page views/session
      • Avg. session length

Will I be able to break down traffic per microapp page?

No, at this time you will not be able to see the traffic per microapp page. You will see traffic per microapp.

How soon can I expect Tiled session data to reach HubSpot?

After a microapp session has occurred, you can see the session data in HubSpot in real-time.

 

Log Tiled emails to HubSpot

Overview

Email logging saves a copy of each microapp email you send from Tiled to the recipient's Contact record in HubSpot. Your team can see what was sent, when, and by whom, without leaving HubSpot.

Behind the scenes, Tiled adds your HubSpot portal's logging address as a hidden BCC on the email. Recipients never see it, and HubSpot files the email on the matching Contact's timeline.

Logged, not tracked

Emails are logged in HubSpot, not tracked. Logging records that the email was sent and what it said. It does not record whether the recipient opened the email or clicked a link in it.

Logged (this feature)

Copy of the email on the Contact timeline

Yes

Sender, date and subject

Yes

Email opens

No

Link clicks in the email

No

To see how recipients engage with the microapp itself, use the HubSpot Session insights feature. It logs each microapp view on the Contact, with time spent and top screens.

Prerequisites

An email is logged only when all of these are true:

  • HubSpot is connected to Tiled with a private app access token that has the contacts read scope (see below).
  • An admin has turned on Email logging for the library you're sharing from.
  • The recipient is already a Contact in HubSpot. Tiled never creates new Contacts. Emails to anyone else are sent as normal but not logged.
  • The sender's email address belongs to a HubSpot user in your portal. HubSpot ignores logged emails from addresses it doesn't recognize.

Set up the HubSpot connection

Tiled connects to HubSpot with a private app access token. For email logging, that token needs the crm.objects.contacts.read scope. Tiled uses it to check that each recipient is an existing Contact before logging. Without it, emails still send but are never logged.

  1. In HubSpot, create a private app, or open the one you already use for Tiled.
  2. On its Scopes tab, add crm.objects.contacts.read and save.
  3. Copy the access token from the app's Auth tab.
  4. In Tiled, go to Account Settings > Integrations > HubSpot. Enter your HubSpot account ID (Hub ID) in HubSpot Application ID, and paste the token in Access Token.

If you added the scope to an app that's already connected, make sure the token saved in Tiled is still the current one.

Turn on email logging (admins)

Email logging is off until an admin turns it on.

  1. Go to Account Settings > Integrations and open HubSpot.
  2. On the Email logging card, turn the feature on.
  3. Choose which libraries it applies to: all libraries, or only the ones you pick. Libraries created later are included unless you exclude them.

Once it's on, everyone sharing from those libraries sees the logging option when they send an email.

Send a logged email

When email logging is on, the share form shows a Log email activity in HubSpot checkbox with the HubSpot logo. It's checked by default.

  1. Open a microapp's share options and choose to send it directly to one or more recipients.
  2. Leave Log email activity in HubSpot checked to log the email, or uncheck it to skip logging for this send only.
  3. Send the email.

Your choice applies only to that email. The checkbox is checked again the next time you share.

Only emails are logged. Copying a share link doesn't log anything, because no email is sent.

Troubleshooting

I don't see the "Log email activity in HubSpot" checkbox. Email logging isn't on for the library you're sharing from. Ask an admin to turn it on, or to add your library to its scope. It also won't appear if HubSpot has been disconnected.

The email didn't show up in HubSpot. Check that:

  • the recipient already exists as a Contact in HubSpot, with the same email address you sent to
  • your email address belongs to a HubSpot user in your portal
  • the checkbox was checked when you sent the email

HubSpot can take a few minutes to add a logged email to the timeline.

Will the recipient know the email was logged? No. The HubSpot logging address is a hidden BCC, so recipients don't see it.

Can I see whether the recipient opened the email? No. Logged emails don't include open or click tracking. Use Session insights to see when and how the recipient viewed the microapp.