HubSpot

A HubSpot integration sends marketing email and message event data from HubSpot to SEINō. Connect the HubSpot account in your workspace settings, then use the Campaigns dataset to review email performance.

What SEINō receives

SEINō reads HubSpot marketing emails and their send, bounce, open, click, spam report, and subscription status events. It combines the email details with those events in the Campaigns dataset. The tables below list the default campaign-level data.

Dimensions

Dimension	Description
Account ID	HubSpot account identifier.
Brand ID	HubSpot business unit identifier, when present.
App name	Name of the app associated with the send event, when present.
Campaign name	Campaign name attached to the marketing email.
Email campaign ID	HubSpot identifier used to match email events to a marketing email.
Email name	Name of the marketing email in HubSpot.
Email variant	A or B variant for an A/B test, when available.
Email type	Type of marketing email returned by HubSpot.
Email subcategory	Subcategory returned for the marketing email, when present.
Send date	Date the email was sent.
Event date	Date of the recorded event.
Subject	Email subject line.
Preheader	Email preview text, when present.
Preview	URL for the email web preview, when available.
Link URL	URL recorded for a clicked link.
UTM source	utm_source value in the clicked URL.
UTM medium	utm_medium value in the clicked URL.
UTM campaign	utm_campaign value in the clicked URL.
UTM term	utm_term value in the clicked URL.
UTM content	utm_content value in the clicked URL.
Send date day	Day component of the send date.
Send date week	Week component of the send date.
Send date month	Month component of the send date.
Send date year	Year component of the send date.
Send date year week	Year-week grouping for the send date.

Metric

Metric	Description
Sent	Number of unique messages sent.
Delivered	Sent messages minus bounced messages.
Opens	Number of unique opens excluding machine activity.
Opens (%)	Opens as a percentage of delivered messages.
Opens incl. bots	Unique opens including machine activity.
Opens incl. bots (%)	Open rate including machine activity.
Clicks unique	Number of unique clicks excluding bot activity.
Clicks unique (%)	Unique clicks as a percentage of delivered messages.
Click to open (%)	Unique clicks as a percentage of opens.
Clicks all	Total clicks excluding bot activity, including repeat clicks.
Clicks unique incl. bots	Unique clicks including bot activity.
Clicks unique incl. bots (%)	Click rate including bot activity.
Bot opens	Opens attributed to machine activity.
Bot clicks	Clicks attributed to bot activity.
Soft bounces	Bounces not classified as hard bounces.
Soft bounces (%)	Soft bounces as a percentage of sent messages.
Hard bounces	Bounces classified as hard bounces.
Hard bounces (%)	Hard bounces as a percentage of sent messages.
Complaints	Spam reports.
Complaints (%)	Complaints as a percentage of delivered messages.
Unsubscribes	HubSpot subscription status change events counted as unsubscribes by SEINō.
Unsubscribes (%)	Unsubscribes as a percentage of delivered messages.
Deliverability (%)	Delivered messages as a percentage of sent messages.

SEINō records HubSpot’s filtered opens and clicks separately as machine activity. It also distinguishes hard bounces from other bounces using the category returned by HubSpot.

HubSpot list membership can be synced when lists are configured for the integration.

HubSpot’s web traffic analytics

HubSpot’s web traffic analytics, including page visits and form events, require additional configuration; they are not part of a new connection by default. Contact support@seino.ai if you need this data source.

Set up the integration

You need access to the SEINō workspace settings and permission to authorize the relevant HubSpot account.

1. Open Workspace settings → Integrations in SEINō and select HubSpot.
2. Select Enable. If HubSpot is already enabled and you want another account, select Add account.
3. Sign in to HubSpot if prompted, choose the account you want to connect, and review the requested access.
4. Select Allow to authorize the connection.
5. Return to SEINō and check that the account appears under Connected accounts.

SEINō uses HubSpot authorization for this connection. You do not need to paste an API key into SEINō.

Check the first sync

After the first sync completes, open the Campaigns dataset in SEINō and look for a recent HubSpot marketing email. Check its send date, campaign or email name, and at least one engagement metric against the corresponding email in HubSpot.

If the account appears in Connected accounts but no email data appears after the first sync, check that the selected HubSpot account contains marketing email events for the date range you are viewing. If it does, contact support@seino.ai.

Limits and notes

• A new HubSpot connection imports marketing email data and message events. List membership and HubSpot web analytics need additional configuration.
• UTM values come from clicked links. A message without a recorded click or without those parameters in its clicked URL will not have those link-level values.
• Email details depend on the fields HubSpot returns for each marketing email. Some fields, such as preheader or preview URL, may be empty.
• Historical data depends on the integration’s start date and the events available from HubSpot.

Troubleshooting

Symptom	What to do
HubSpot authorization was declined	Select Enable or Add account again and select Allow in HubSpot.
The account shows an invalid credentials warning	Reconnect the HubSpot account. If the warning remains, contact support@seino.ai.
The account is connected but campaign data is missing	Confirm the HubSpot account and date range, then allow time for the first sync. Contact support if data remains missing.
List or web analytics data is missing	Contact support@seino.ai to check whether that data source has been configured.