Hello!
I’d like to check the status of sent transactional email after it has been sent out.
I’m testing “Query the status of an email” (Marketing API | Marketing Email - HubSpot docs) but I’m noticing that hard bounces are marked as SENT with this API (something I’d like to catch as well), while they’re marked correctly as bounced within Hubspot interface for given contact.
Is there an API I can use to retrieve the information about bounces as well?
Hey, @pawel-trauth Thanks for the interesting question. Can you share an example response? Does it include an EventId?
If so, you can look at the Email Events API as it will return delivery details. The Email Events API allows you to get information about email events such as sent, delivered, opened, clicked, bounced, etc., which might help you in getting the detailed status of your emails.
Full disclosure, I haven’t tested this endpoint with Transactional Emails specifically. If it doesn’t work, please let me know, and we will get more details or find an alternative if possible.
- filter obtained events by sentBy property of given event using EventId - this will result in all events for given recipient in response to initial send
At this point we can look at the history of events and check if any of them has DROPPED or BOUNCED type (this represents status of delivery). Data obtained from send-statuses endpoint gives us information about status of sending - status (this represents status of event itself) and sendResult (this respresents status of sending)
We received an e-mail that v3 will not be supported after September 2027 on.
After September 2027, these endpoints will be unsupported
and
Migrate directly from any legacy version to date-based versioning (DBV). Do not use v3 or v4 as an intermediate step.
You’re right that v1-v3 APIs go unsupported in September 2027. The marketing email send-statuses replacement hasn’t been published in the current releases; per the changelog:
“Not all legacy replacement paths are finalized yet. The March 2027 DBV release will include full per-endpoint replacement documentation for every legacy API. You have until September 2027, so plan your timeline accordingly.”
Understandably, this is frustrating and takes real time to work through. If you’d like to go deeper on how changes like this affect your team and clients, or what you’d like to see done differently, the HubSpot Developer Feedback Form is the best place to share that.