---
title: "Connecting HubSpot to Opensense"
slug: "hubspot-integration"
description: "Connect HubSpot to Opensense, then add the sgenads and sgentags contact properties, so HubSpot workflows can choose the banner each recipient sees."
updated: 2026-10-14T00:00:00.000Z
canonical: "https://help.opensense.com/docs/hubspot-integration"
---

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

# Connecting HubSpot to Opensense

## Overview

The HubSpot integration gives you real-time campaign personalization in the space under your outbound email signature, from within HubSpot workflows. For example:

<dl class="kb-insights-summary">
  <div><dt id="example-1">Example 1</dt><dd>Personalized banners for events, that go out only to senior management roles or higher.</dd></div>
  <div><dt id="example-2">Example 2</dt><dd>Event registrants get a "Thank you" banner with relevant information, such as speaker spotlights, on random rotation.</dd></div>
</dl>


## Connecting HubSpot

:::note[Before you start]
You need HubSpot admin privileges.
:::

1. In the Opensense portal, open the **Manage** menu, and select **Domain Settings**.
2. In the Domain Settings menu, select **Integrations** > [**HubSpot**](https://app.opensense.com/beta/manage/domain-settings/integrations#integrations-hubspot).
3. Select **Connect**.

   ![The HubSpot section of Domain Settings, with the Connect button, Frictionless Landing Pages enabled, and the Hub ID field](https://help.opensense.com/media/image-1758851321364-c77d42c30f0b.png)

4. HubSpot asks you to grant Opensense access to the HubSpot API. Grant it.
5. When access is granted, a landing page confirms the installation. Select **Click here to continue** to go to the Opensense portal, or close the browser tab.

   ![The Opensense landing page: Success! You have completed the HubSpot installation, with a Click here to continue button](https://help.opensense.com/media/image-1758852967261-b61d02f53a6a.png)

:::note[What connecting turns on]
When you grant the permissions, Opensense automatically turns on **Frictionless Landing Pages** and imports your **Hub ID**.
:::


## Adding the Opensense properties in HubSpot

Opensense reads two custom contact properties, `sgenads` and `sgentags`. Create both:

1. In HubSpot, select the settings icon in the top navigation bar.

   ![The HubSpot top navigation bar, with the settings icon circled](https://help.opensense.com/media/image-1758855337013-1ae7b4c55a14.png)

2. In the left sidebar, select **Properties**.
3. In the **Select an object** menu, select **Contact properties**.

   ![HubSpot property settings, with the Contact properties tab and the Create a property button](https://help.opensense.com/media/hubspot4-03b760ad0abf.png)

   The screenshot shows an older layout of HubSpot's property settings, with the objects as tabs and the button named **Create a property**.

4. Select **Create property**, and enter the values below. To add the description, select **Edit more options**.
5. Select **Create**.
6. Repeat for the second property.

<div class="kb-deployment-compare kb-deployment-compare--plain">
  <div class="kb-deployment-compare__viewport" role="region" aria-label="The two Opensense contact properties" tabindex="0">
    <table>
      <colgroup><col class="kb-deployment-compare__feature-col"></colgroup>
      <thead>
        <tr>
          <th scope="col">Setting</th>
          <th scope="col"><span class="kb-deployment-compare__method"><code>sgenads</code></span></th>
          <th scope="col"><span class="kb-deployment-compare__method"><code>sgentags</code></span></th>
        </tr>
      </thead>
      <tbody>
        <tr><th scope="row">Label</th><td><code>sgenads</code></td><td><code>sgentags</code></td></tr>
        <tr><th scope="row">Description</th><td>Opensense Ads (Static)</td><td>Opensense Ads (Campaign Tag)</td></tr>
        <tr><th scope="row">Object type</th><td>Contact</td><td>Contact</td></tr>
        <tr><th scope="row">Field type</th><td>Single-line text</td><td>Single-line text</td></tr>
        <tr><th scope="row">What the workflow writes</th><td>The <strong>name of the banner</strong> to display. This assigns one dedicated, static banner, which is less dynamic than <code>sgentags</code>.</td><td>A banner tag value shared by multiple banners. The contact sees any banner tagged with the same value as their <code>sgentags</code> field.</td></tr>
      </tbody>
    </table>
  </div>
</div>

Use a [HubSpot workflow](https://help.opensense.com/docs/create-a-hubspot-workflow) to update these contact properties.

## Testing and training

When you've finished these steps, contact your Opensense account manager (or the [help desk](mailto:help@opensense.com)) for testing and training.


## What's next

- [Assigning Opensense tags with a HubSpot workflow](https://help.opensense.com/docs/create-a-hubspot-workflow)
- [Targeting with CRM or marketing automation platforms](https://help.opensense.com/docs/targeting-with-crm-or-marketing-automation-platforms)

For further help, contact Opensense Support at [help@opensense.com](mailto:help@opensense.com).