Email Events v1 Replacement

Developer Support APIs & Integrations
1

I have been made aware that the “/email/public/v1” endpoints will be retired in October 2025, but I am having difficultly finding the replacement endpoints in the v3 APIs. The 2 endpoints that I can’t find a replacement for are:

  1. /email/public/v1/events?startTimestamp=[timestamp]
    To get a list of recent events. From this I extract the Contact Emails of the contacts that have recent changes to thier events.
  2. /email/public/v1/events?recipient=[EmailAddress]
    Then this endpoint is used to get all events for each contact with updates to be able to process the updates into the linked system.

Note: I have tried the “/events/v3/events” endpoint but it does not seem to capture the “Delivered” event which is one that I need for my integration.

What are my alternatives to replace this functionality? I can’t seem to find anything documented in the CRM or Marketing APIs to be able to get email events associuated to a contact at all. Any suggestions?

2

Hi @BretThompson and welcome, it’s a pleasure to have you here! :hugs:
Thanks for reaching out to the HubSpot Community!
Could you share the article or post where you saw that these endpoints will be retired, please?
On the documentation itself “Event Analytics”, I don’t see any message about this.
I also cannot find it listed here: “Sunsetted and deprecated APIs”.
Once I have the link to this information, I’ll be checking on this for you.
Thanks and have a beautiful day!
Bérangère

3

This is the article that triggered me to look into this.

Marketing Email API: v3 released to general availability and upcoming sunset for v1

But I guess it does not specifiy exactly which endpoints are getting depreciated.

4

Hi @BretThompson, I hope you’re doing well!

Thank you so much for sharing the link.

After reviewing the documentation, I noticed that indeed, the Marketing Email V1 API will soon be sunset.

There’s a helpful thread discussing this topic: “Marketing Email API: v3 released to general availability and upcoming sunset for v1” where I see you posted your question (thank you).
I am adding the reply here so that it can help other Community Members who will find this thread:
"This sunset only affects the marketing email API endpoints beginning with the url /marketing-emails/v1/emails. There are no changes to other email related APIs at this time, including the email analytics API

The allEmailCampaignIds field has now been added to the v3 API, and should include the same IDs that you would get from the v1 API in the same format of an array of IDs."

I hope this helps!
Bérangère