topic Checking sent email status in APIs & Integrations

Checking sent email status

pawel-trauth — Thu, 31 Aug 2023 09:55:36 GMT

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" (https://developers.hubspot.com/docs/api/marketing/transactional-emails) 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?

Re: Checking sent email status

Jaycee_Lewis — Fri, 01 Sep 2023 07:25:07 GMT

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.

Best,

Jaycee

Re: Checking sent email status

pawel-trauth — Fri, 01 Sep 2023 10:49:54 GMT

Hello Jaycee!

Thanks for prompt response - your answer helped me achieve what I'm after. For anybody googling on how to obtain the information in OP:

- obtain StatusId of email sent via Single-Send API

- make a request to https://api.hubapi.com/marketing/v3/email/send-statuses/{statusId} - given COMPLETE status an EventId will be returned

- make a request to http://api.hubapi.com/email/public/v1/events/?recipient={email}&startTimestamp={timestamp of sending email}&endTimestamp={timestamp of now} - this will result in all events since sent email and now

- 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)