Marketing Emails API v1 lifetime stats → v3 equivalent?

Developer Support APIs & Integrations
1

Hi,
We’re migrating from Marketing Emails API v1 to v3 ahead of the October 1, 2025 sunset.
In v1, we relied on an endpoint that returned lifetime (all-time) statistics for marketing emails.
https://api.hubapi.com/marketing-emails/v1/emails/with-statistics
From the v3 docs and examples, I do not see a way to request lifetime totals. The highest aggregation I can find appears to be yearly.
Could you confirm whether v3 has an equivalent “lifetime” metric or a supported pattern to obtain it?

2

Hi @SnirYadid, I hope that you are well!

Thank you for bringing up this important question regarding the Marketing Emails API migration!

You’re correct that, in v1 of the API, it was possible to retrieve lifetime (all-time) statistics for marketing emails using the /v1/emails/with-statistics endpoint.
With v3, based on the current documentation and available endpoints, the highest aggregation for statistics appears to be at the yearly level.
There isn’t a direct equivalent “lifetime” stats endpoint in v3 at this time.

To approximate lifetime totals with v3, you could try to programmatically aggregate annual, monthly, or daily statistics across all time periods available for your account.
While this does require more processing on your end, it should enable you to achieve a lifetime (all-time) view of the metrics you need.
I’d love to put you in touch with our Top Experts: Hi @sylvain_tirreau, @Anton and @zach_threadint do you have tips or example queries for aggregation to help @SnirYadid, please?
Also, I’d recommend that you submit the “HubSpot Developer Feedback form” to share your valuable feedback regarding the importance of a dedicated lifetime totals endpoint for analytics in future updates!
Have a wonderful day and thanks so much in advance for your help!
Bérangère

3

Hi,

You can call the v3 API with a very wide date range (e.g., since the start of use) and sum the returned values to get an approximate “total lifetime” yourself. It’s not perfect, but it’s better than nothing.

4

Thank you for your reply.

5

Hi @SnirYadid , totally get the concern moving to v3 in 2025 and losing a single “lifetime” switch feels like a step back.

Short answer: v3 doesn’t expose an all-time/lifetime toggle. The stats endpoints require a time span, so the native path is to query a very wide window and aggregate on your side.

Start with Get aggregated statistics at /marketing/v3/emails/statistics/list, which returns totals for the period you pass and can be filtered by specific email IDs; when you need consistent buckets for paging or rollups, use the histogram variant to iterate year or month slices and sum opens/clicks/bounces/delivereds yourself

(Accounts Dashboard | HubSpot )

(https://developers.hubspot.com/docs/api-reference/marketing-marketing-emails-v3-v3/statistics/get-marketing-v3-emails-statistics-histogram )

Two practical advices: pick a stable lower bound (e.g., your earliest email send date) and cache partial rollups so you don’t recompute from the beginning each time. Also watch for interval caps; if your window is too large, fall back to yearly slices via histogram and fold them.

For completeness, HubSpot’s changelog confirms the v1 sunset on October 1, 2025, so building this rollup now saves you another migration later (Marketing Email API: v3 released to general availability and upcoming sunset for v1 )

One quick question to guide the shape of the rollup: do you need lifetime totals per email, or an account-wide lifetime rollup across all marketing emails? If keeping HubSpot and your other system in step is the real blocker, Stacksync keeps both sides aligned in near real time so you don’t chase fixes later.