Marketing Email events API

[LDiP3]

Hi guys,

I would like to replicate a timeline email marketing event like the one in the screen, using the API.

I've read the documentation but I can't figure out which endpoint I need to use and how to set the association with the contact.

[SteveHTM]

Marketing emails sent by HubSpot are self instrumented - you get the timeline of events automatically recorded. The association is basically set as which contact(s) you sent the email to. This API is to help programmatically create and manage these emails, not augment the reporting.

So I'm not sure I undertstand what you are really looking to program through an API here.

Steve

[LDiP3]

Thanks Steve,

right, I want to be more precise in what I would like to achieve: I have my own external email marketing service (not natively integrated) and would like to insert, via a public app, conversion events (sent, open, click) within the contacts in Hubspot. I don't know whether the feature is only available at this point if the emails are sent directly into hubspot.

[SteveHTM · Accepted solution]

Since you are not using "Marketing emails" is the strictly HubSpot defined sense, I think I would go back to my initial suggestion of logging emails from your application as Engagements.

Seems to me to be a lot of reinvention of the wheel when you are using HubSpot as a marketing automation tool, but I'm sure you have your reasons.

Steve

[SteveHTM]

@LDiP3 - I think you are looking for the 'engagements' API - https://developers.hubspot.com/beta-docs/reference/api/crm/engagements/email. The naming may be questionable, but it does work pretty well for adding events on the timeline of a contact or other object.

Good luck!

Steve

[LDiP3]

@SteveHTM Thanks for the answer!

I did try it, but the fact is that with this type of engagement you can only associate a standard email and not a marketing email with a timeline of actions...

So I think the documentation I need to refer to is this: https://developers.hubspot.com/beta-docs/reference/api/marketing/emails/marketing-emails

but I don't know which endpoint to use and what format to use!