How to get Marketing email content for V3 version API

Developer Support APIs & Integrations
1

HubSpot Experts – Need Guidance on Migration Strategy

Use Case:
John is a member of Army Credit Union and has received 10 marketing emails from HubSpot.

Requirement:
We want to display key email details such as for each email

1.Subject
2.Created Date
3.Web version URL of each email sent to John

Current Integration (Using v1 APIs):
Step 1: Retrieve all email events for a contact
GET https://api.hubapi.com/email/public/v1/events?recipient=email&eventType=SENT

Step 2: Extract emailCampaignId from each event and fetch campaign details
GET https://api.hubapi.com/email/public/v1/campaigns/{{emailCampaignId}}?limit=1

Step 3: Use the contentId from the campaign to get email content
GET https://api.hubapi.com/marketing-emails/v1/emails?orderBy=-created&limit=1

Issue:
HubSpot has announced the deprecation of the v1 Marketing Email API effective October 1, 2025.

Updated Integration Approach:
Steps 1 & 2 remain unchanged (until HubSpot provides a v3 alternative for email events).

Step 3 is now replaced with the v3 Marketing Email API, using the campaign ID as the email ID:

GET https://api.hubapi.com/marketing/v3/emails/107383476337

Question:
Given that v1 Marketing Email APIs are being phased out, what is the recommended approach to:

1.Retrieve email send history for a contact
2.Display the full email details (subject, created date, web view URL)

Any guidance on aligning our integration fully with v3 APIs would be greatly appreciated.

Thanks in advance!

2

Hi @SnovielLopes, I hope that you are well!
Thanks for asking the HubSpot Community!
I’d love to put you in touch with our Top Experts: Hi @sylvain_tirreau, @zach_threadint and @Bortami do you know of a way to achieve this via API to help @SnovielLopes, please?
Have a lovely day and thank you very much for your help! :heart:
Bérangère

3

Hi @SnovielLopes, I hope that you are well!
I wanted to check on you: do you still need help?
Thanks,
Bérangère

4

Hello @BérangèreL , Thanks for reaching out ,I am still looking for the answer on my query.

I want to know if below 2 API are getting deprecated or not

Step 1: Retrieve all email events for a contact
GET https://api.hubapi.com/email/public/v1/events?recipient=jasontmiani@gmail.com&eventType=SENT

Step 2: Extract emailCampaignId from each event and fetch campaign details
GET https://api.hubapi.com/email/public/v1/campaigns/{{emailCampaignId}}?limit=1

5

Hi @SnovielLopes, thanks for your reply!
I’d love to put you in touch with other Top Experts to see if they can share some insights: Hi @Anton, @MichaelMa and @GiantFocal do you have suggestions to help @SnovielLopes, please?
Have a great day and thanks so much in advance!
Bérangère

6

Hi @SnovielLopes and thanks for your patience as I was checking on this for you!
I can confirm that the 2 docs below are accurate, these are stable:

- Step 1: Retrieve all email events for a contact
GET https://api.hubapi.com/email/public/v1/events?recipient=email&eventType=SENT

- Step 2: Extract emailCampaignId from each event and fetch campaign details
GET https://api.hubapi.com/email/public/v1/campaigns/{{emailCampaignId}}?limit=1

This API is fully supported.
Being “older” just means it’s been around for a while, not that it’s deprecated.
I hope this helps!
Have a wonderful day and I look forward to seeing you around the HubSpot Community! :hugs:
Bérangère