topic Re: Marketing Email events API in APIs & Integrations

Marketing Email events API

LDiP3 — Tue, 10 Dec 2024 09:52:02 GMT

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.

Re: Marketing Email events API

SteveHTM — Tue, 10 Dec 2024 18:15:55 GMT

@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

Re: Marketing Email events API

LDiP3 — Wed, 11 Dec 2024 09:56:02 GMT

@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!

Re: Marketing Email events API

SteveHTM — Wed, 11 Dec 2024 23:44:33 GMT

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

Re: Marketing Email events API

LDiP3 — Thu, 12 Dec 2024 08:15:22 GMT

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.

Re: Marketing Email events API

SteveHTM — Thu, 12 Dec 2024 22:05:21 GMT

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