HubSpot email campaign management - Unclear how to identify "reliable" opens from event data

Developer Support APIs & Integrations
1

We’re currently seeing a disparity between email events and campaign data where the campaign marketing data includes a “reliable” logic, i.e. opens by an individual that can reliably be identified as a human.
There is no for an event to easily identifiy if it was created by a reliable human or not, causing disparities between aggregated event data & the output of the campaigns API.

Therefore, we would like to know:

  • How can we identify email events to be “reliable” through the API?
  • What is the best way to access granular email events (Opens, Clicks, etc.) and to associate them to i) an email campaign AND ii) a specific hubspot contact.
2

Hey, @VPrimerano :waving_hand: Thanks for the question. This is one that has come up before in the community. The honest answer is — it’s not possible to directly identify “reliable” opens (human vs. bot) through our API. While this logic is applied in-app in reporting, the Email Events API doesn’t flag individual events as reliable.

For granular tracking, use the Email Events API to access opens, clicks, etc., and link them to campaigns with the `campaignId` and contacts via the `recipient`. Filtering for reliable opens would require custom logic.

For aggregated data, the Email Analytics API includes performance metrics, but without event-level reliability details.

I hope this helps get you moving forward — Jaycee