Reading email history of contacts

[tonygoodchild]

I'm trying to find a suitable API to read the status of emails sent to a contact by a sales person.

This isn't for marketing email sent from marketing hub, but a single email sent from a salesperson through the Contact page in Hubspot.

I want to be able to read the history of emails and see how may times they have been clicked and read.

Is there a suitable way to accomplish this?

[tonygoodchild]

I've hit a bit of a roadblock, I can get the latest email using the engagements API as mentioned, and can see various data about it like:

trackerKey

messageId

threadId

uid

I've tried pushing these by the /email/public/v1/events/ endpoint but don't get anything back.Is there a way to specifically query the email and retrieve the counts of Read, Opens and Clicks?

[dennisedson]

@tonygoodchild ,

Have you explored this endpoint?

[dennisedson · Accepted solution]

@tonygoodchild 

You will have to work with a couple different endpoints to get these data.

1:  for the email engagement, you will need to query the engagements endpoints

2:  for clicks, there is not a good solution (that I am aware of).  You will have to look at the Contact Object and request values for this properties:

Recent sales email clicked date (Sales Hub Professional and Enterprise only)

Recent sales email open date

Recent sales email replied date

You could set up webhooks to subscribe to these changes and keep a count in your app that way...

@lynton , @tominal any thoughts?

[tonygoodchild]

Awesome, thanks!