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"
      ]
    }
  ]
}
Example: "Sent emails" in October, compared to September.

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_emails
  • Emails delivered

    The number of emails successfully delivered to an inbox, during the analysis period.

    hubspot_marketing:delivered_emails
  • Email clicks

    The number of unique recipients who clicked on any link in your email, excluding the Unsubscribe and Subscription Preferences links.

    hubspot_marketing:click_emails
  • Unique Opens

    The total number of unique opens during the analysis period

    hubspot_marketing:open_emails
  • Hard 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_emails
  • Spam 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_emails
  • Unsubscriptions

    The number of contacts who received your email and unsubscribed during the review period.

    hubspot_marketing:unsubscribed_emails
  • Unsubscribe rate

    The percentage of recipients who unsubscribed from your email during the analysis period.

    hubspot_marketing:unsubscribedratio_emails
  • Spam reports rate

    Percentage of emails that were marked as spam among those that were delivered to recipients.

    hubspot_marketing:spamreportratio_emails
  • Hard 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_emails
  • Open rate

    Open rate is the percentage of people who opened your email out of the people who were delivered your email.

    hubspot_marketing:openratio_emails
  • Email delivered rate

    Percentage of emails that were delivered to recipients, compared to the amount of emails sent.

    hubspot_marketing:deliveredratio_emails
  • Email 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_emails
  • Click-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_emails
  • Entrances

    Total number of people who started filling out the form on the page during the analyzed period.

    hubspot_marketing:entrances_landing_pages
  • Exits

    Total number of people who exited the form before submitting it, during the analyzed period.

    hubspot_marketing:exits_landing_pages
  • Landing page views

    Total number of landing page views during the analyzed period.

    hubspot_marketing:rawViews_landing_pages
  • Landing pages bounce rate

    Percentage of users who viewed your landing page but left without taking any action.

    hubspot_marketing:pageBounceRate_landing_pages
  • Total submissions

    Total number of form submissions during duration periods.

    hubspot_marketing:submissions_landing_pages
  • New contacts

    Number of new leads picked up by the landing page during the analysis period.

    hubspot_marketing:contacts_landing_pages
  • Average 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_pages
  • Average 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_pages
  • CTA views

    Number of times the CTA was displayed on screen during the analysis period.

    hubspot_marketing:ctaViews_landing_pages
  • Submission 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_pages
  • Blog posts views

    Number of views your blog got in the analyzed period.

    hubspot_marketing:rawViews_blogs
  • Blogs 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_blogs
  • Website 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_sites
  • Page/Session Views

    Average number of page views per session during the analyzed period.

    hubspot_marketing:page_sessions_views_sites
  • New sessions %

    Percentage of new user sessions during the analyzed period.

    hubspot_marketing:new_sessions_rate_sites
  • Average session duration

    Average duration of a website session by the visitor, during the analyzed period.

    hubspot_marketing:time_per_session_sites
  • Website bounce rate

    Percentage of visitors to a specific site who leave the site after viewing just one page.

    hubspot_marketing:bounce_rate_sites
  • Customers

    Number of customers that originally converted to your website during the analysis period and are currently in the Customer lifecycle stage.

    hubspot_marketing:customers_sites
  • Customer 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_sites
  • Contact 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_sites
  • New visitors

    Number of new unique visitors to your site during the analyzed period.

    hubspot_marketing:new_visitors_sites
  • New 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_chart
  • Contact Type

    The number of new and existing contacts that have submitted the form.

    hubspot_marketing:contacts_type_chart
  • Sessions over time

    Number of sessions your site received over the analyzed period.

    hubspot_marketing:sessions_over_time_chart
  • Customers 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_datatable
  • Summary of forms

    Performance summary of the analyzed period forms.

    hubspot_marketing:forms_datatable
  • Featured posts

    Blog posts that had the most views during the analyzed period.

    hubspot_marketing:blogs_datatable
  • Submissions 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_landing
  • Featured countries

    This table details the site traffic by the countries of your visitors

    hubspot_marketing:sites_countries_datatable
  • UTM 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_datatable
  • Origin 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_sites
  • Top 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.