Metrics
HubSpot Marketing metrics via API
Your customer connects their HubSpot Marketing account and your product queries 48 metrics through the same endpoint as every other platform. Each metric has an id (reference_key) that goes in the request.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"comparison_start": "2026-09-01",
"comparison_end": "2026-09-30",
"metrics": [
{
"id": "m1",
"reference_key": "hubspot_marketing:sent_emails",
"component": "number_v1",
"metrics": [
"stats.counters.sent"
],
"dimensions": [
"emails"
]
}
]
}More HubSpot Marketing request examples
The same endpoint for every kind of metric. The metrics and dimensions of each item come from the platform catalog (GET /api/metrics/{integration_slug}).
Chart
Views by device
Number of views by site sessions, grouped by the type of device the visitor used.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "hubspot_marketing:sessions_by_device_chart",
"component": "chart_v1",
"metrics": [
"desktop",
"mobile",
"others"
],
"dimensions": [
"device"
]
}
]
}Table
Featured Emails
Performance summary of emails sent during the analysis period.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "hubspot_marketing:emails_datatable",
"component": "datatable_v1",
"metrics": [
"stats.counters.sent",
"stats.counters.delivered",
"stats.counters.open",
"openratio",
"deliveredratio",
"clickratio",
"clickthroughratio"
],
"dimensions": [
"emails"
]
}
]
}Number
Emails delivered
The number of emails successfully delivered to an inbox, during the analysis period.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "hubspot_marketing:delivered_emails",
"component": "number_v1",
"metrics": [
"stats.counters.delivered"
],
"dimensions": [
"emails"
]
}
]
}Numbers
36 metrics
Sent emails
The total number of emails sent during the analyzed period.
hubspot_marketing:sent_emailsEmails delivered
The number of emails successfully delivered to an inbox, during the analysis period.
hubspot_marketing:delivered_emailsEmail clicks
The number of unique recipients who clicked on any link in your email, excluding the Unsubscribe and Subscription Preferences links.
hubspot_marketing:click_emailsUnique Opens
The total number of unique opens during the analysis period
hubspot_marketing:open_emailsHard bounce emails
The number of times your emails could not be delivered because the email address was invalid or no longer in use, or because the email was marked as spam.
hubspot_marketing:hardbounced_emailsSpam reports
Number of contacts who reported this email as spam to their email provider, or manually dragged the email from their inbox into their junk folder.
hubspot_marketing:spamreport_emailsUnsubscriptions
The number of contacts who received your email and unsubscribed during the review period.
hubspot_marketing:unsubscribed_emailsUnsubscribe rate
The percentage of recipients who unsubscribed from your email during the analysis period.
hubspot_marketing:unsubscribedratio_emailsSpam reports rate
Percentage of emails that were marked as spam among those that were delivered to recipients.
hubspot_marketing:spamreportratio_emailsHard bounce emails rate
The percentage of your emails that couldn't be delivered because the email address was invalid or no longer in use, or your email was marked as spam.
hubspot_marketing:hardbounceratio_emailsOpen rate
Open rate is the percentage of people who opened your email out of the people who were delivered your email.
hubspot_marketing:openratio_emailsEmail delivered rate
Percentage of emails that were delivered to recipients, compared to the amount of emails sent.
hubspot_marketing:deliveredratio_emailsEmail click rate
Click rate is the percentage of people who clicked a link in your email out of the people who were delivered your email.
hubspot_marketing:clickratio_emailsClick-through rate
The percentage of people who clicked a link in your email out of the number of people who opened your email.
hubspot_marketing:clickthroughratio_emailsEntrances
Total number of people who started filling out the form on the page during the analyzed period.
hubspot_marketing:entrances_landing_pagesExits
Total number of people who exited the form before submitting it, during the analyzed period.
hubspot_marketing:exits_landing_pagesLanding page views
Total number of landing page views during the analyzed period.
hubspot_marketing:rawViews_landing_pagesLanding pages bounce rate
Percentage of users who viewed your landing page but left without taking any action.
hubspot_marketing:pageBounceRate_landing_pagesTotal submissions
Total number of form submissions during duration periods.
hubspot_marketing:submissions_landing_pagesNew contacts
Number of new leads picked up by the landing page during the analysis period.
hubspot_marketing:contacts_landing_pagesAverage page view time
Average time visitors viewed your landing page. It's calculated by dividing the total view time by the number of views.
hubspot_marketing:timePerPageview_landing_pagesAverage exits per page view
Percentage of users who viewed your landing page but left without converting. This metric is calculated by dividing the number of exits by the number of views.
hubspot_marketing:exitsPerPageview_landing_pagesCTA views
Number of times the CTA was displayed on screen during the analysis period.
hubspot_marketing:ctaViews_landing_pagesSubmission rate
Percentage of form submissions compared to the number of form views during the selected time period. The submission rate is calculated by dividing the number of form submissions by the number of views.
hubspot_marketing:sentRate_landing_pagesBlog posts views
Number of views your blog got in the analyzed period.
hubspot_marketing:rawViews_blogsBlogs bounce rate
Percentage of visitors who accessed a single page on your company's website and then left without continuing to browse.
hubspot_marketing:pageBounceRate_blogsWebsite sessions
Number of sessions that occurred during the analyzed period. A session is a series of analytics activities performed by a visitor on your website. Activities can include page views, CTA clicks, events, etc. A session expires after 30 minutes of inactivity.
hubspot_marketing:rawViews_sitesPage/Session Views
Average number of page views per session during the analyzed period.
hubspot_marketing:page_sessions_views_sitesNew sessions %
Percentage of new user sessions during the analyzed period.
hubspot_marketing:new_sessions_rate_sitesAverage session duration
Average duration of a website session by the visitor, during the analyzed period.
hubspot_marketing:time_per_session_sitesWebsite bounce rate
Percentage of visitors to a specific site who leave the site after viewing just one page.
hubspot_marketing:bounce_rate_sitesCustomers
Number of customers that originally converted to your website during the analysis period and are currently in the Customer lifecycle stage.
hubspot_marketing:customers_sitesCustomer conversion rate
Percentage of users that were converted into customers during the analyzed period. This fee is calculated by dividing the number of clients by the number of sessions.
hubspot_marketing:conversions_customers_sitesContact conversion rate
This rate is calculated by dividing the number of contacts by the number of sessions in the analyzed period.
hubspot_marketing:conversions_contact_sitesNew visitors
Number of new unique visitors to your site during the analyzed period.
hubspot_marketing:new_visitors_sitesNew website contacts
Number of new contacts created during the analyzed period.
hubspot_marketing:new_contacts_sites
Charts
4 metrics
Views by device
Number of views by site sessions, grouped by the type of device the visitor used.
hubspot_marketing:sessions_by_device_chartContact Type
The number of new and existing contacts that have submitted the form.
hubspot_marketing:contacts_type_chartSessions over time
Number of sessions your site received over the analyzed period.
hubspot_marketing:sessions_over_time_chartCustomers over time
Number of users that were converted into customers over the period analyzed.
hubspot_marketing:customers_over_time_chart
Tables
8 metrics
Featured Emails
Performance summary of emails sent during the analysis period.
hubspot_marketing:emails_datatableSummary of forms
Performance summary of the analyzed period forms.
hubspot_marketing:forms_datatableFeatured posts
Blog posts that had the most views during the analyzed period.
hubspot_marketing:blogs_datatableSubmissions by source
The views, submissions, and conversion rate by the source of the session when the form was submitted.
hubspot_marketing:forms_per_origin_datatable_landingFeatured countries
This table details the site traffic by the countries of your visitors
hubspot_marketing:sites_countries_datatableUTM parameters
This table allows you to analyze traffic data in terms of UTM parameters in the URLs that visitors are using to access your site. This includes reviewing any manual tracking URLs you've created.
hubspot_marketing:sites_utm_datatableOrigin of sessions
This table provides a summary of the main sources that brought traffic to your site, and a summary of the interaction of the visitors in each of them.
hubspot_marketing:origin_datatable_sitesTop pages
Hubspot page performance summary during the analyzed period.
hubspot_marketing:top_pages_datatable_sites
See Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
