HubSpot Developer Changelog

Breaking Change for DateTime Properties in Marketing Emails

Written by Hannah Seligson | Jan 16, 2025 2:55:32 PM

Starting April 16th, 2025, any DateTime properties in your HubSpot CRM used as personalization tokens in Marketing Emails will now include both the date and time stored in the property rather than just the date.

This change enhances functionality by including date and time in personalized emails, such as event or meeting reminders.

What's changing?

Previously, only the date portion of the property was included when a DateTime property was used as a personalization token in a Marketing Email. Now, the DateTime properties will include both the date and the time stored in the property. 

Therefore, any custom DateTime properties used in emails will now automatically reference the time in addition to the date. 

The locale-based format for dates remains the same. The time is simply appended to the existing date format. As for timezone handling, the time displayed is based on the timezone configured in your HubSpot portal, not the recipient’s timezone.

What does this mean for developers?

If you use the DateTime properties as tokens in emails, these tokens will now include the time by default. Developers must account for this change when defining or using such tokens.

This change also requires adjusting any existing HubL conditional logic or filters that check if a property matches an exact date. For example: 

  • Old Behavior: A custom property rendered as 2025-01-14.
  • New Behavior: The same property now renders as 2025-01-14 14:00:00.

Update conditions to handle the new datetime format if necessary.

Also, any integrations, workflows, or scripts that process DateTime properties may need updates to ensure they appropriately handle both date and time values.

When is it happening?

This change goes into effect on April 16th, 2025.

Questions or comments? Join us in the developer forums for a peer-to-peer discussion.