Read custom property values of marketing emails via API

Hi,

I created custom properties on the “Marketing email” object (0-29), for example Does it have CTAs? with the internal name tiene_ctas, and I need to read their values via the API. I can’t figure out how to do it and would like to know if anyone has managed to.

Here is what I have tried:

  1. The properties API does see them:
    GET /crm/properties/2026-09/0-29
    → returns tiene_ctas without any issue.

  2. The marketing emails API does not return them:
    GET /marketing/emails/2026-09/{emailId}?includedProperties=tiene_ctas
    → the response only includes id, isAb, and type. As far as I can tell from the specification, includedProperties filters the email’s own fields, and custom properties are not part of that schema.

  3. The CRM objects API doesn’t work either:
    GET /crm/objects/2026-09/0-29/{recordId}?properties=tiene_ctas
    POST /crm/objects/2026-09/0-29/search
    → both return:
    "Object type MARKETING_EMAIL is not supported by this endpoint, supported object types [APPOINTMENT, CALL, CAMPAIGN, ...]"

In other words, HubSpot allows defining properties on 0-29 and lists them, but I don’t see any way to read their values.

Is there a public endpoint to read these values that I might be missing?

Any hints would be appreciated.
Thanks in advance.

Egoi.

Hey @Egoi, I ran into the same thing a while back. Unfortunately, you’re not missing anything.

The Properties API lists them because the definitions live on 0-29, but the values don’t sit on a CRM record you can query. They’re held by the email tool itself. That’s why /crm/objects rejects MARKETING_EMAIL. And the Marketing Emails API response just doesn’t have a field for custom properties, so includedProperties won’t bring them back. I checked the 2026-09 spec and the recent changelogs too, and nothing exposes them yet. Right now it’s a UI-only feature.

What i ended up doing was building a custom report on the Marketing emails data source, adding tiene_ctas as a column, and exporting that. It’s not real-time, but you get the email ID with its value, which was enough for me. If you need it live through the API, the only clean option I know is to keep the value somewhere you can read, like a mapping table on your side keyed by email ID.

Thanks for your reply! I’m afraid I’ll just have to wait then.

Best regards!

Hi @Egoi and Happy Monday!

Thanks for your question on the HubSpot Community! :orange_heart:

I can confirm what @Alex_Boissonneault shared (thank you!), currently there isn’t an API for retrieving custom property values from the Marketing Email (0-29) object.

The Marketing Emails API and its Get Email endpoint expose predefined fields but don’t retrieve custom properties through includedProperties.

Additionally, the CRM Objects API lists MARKETING_EMAIL as an unsupported object type.

I’d suggest submitting this via the HubSpot Developer Feedback Form so that the Team can have their eyes on it.

Thanks so much and have a lovely day!

Bérangère