We've added a new member_email
property to contacts which dictates where membership emails (password reset, password confirmation, and registration) are sent. The following users should be aware of this new property:
This property is not the email address used by the member contact when they want to log in, member_email
only controls where membership emails are sent. This means the user will continue to login to their account using the email address in the email
contact property.
This change is not expected to have any negative effects on existing apps/integrations. If your app syncs email addresses from another system or otherwise modifies contact email addresses, consider adding a toggle to your app's settings so account owners can dictate whether changes your app makes to the email field should also apply to the member_email
property.
If your app updates a contact's member_email
property, they will not receive a confirmation/verification email, so you should only update this property when you are confident the contact has the ability to receive emails at this address.
A company has a web/mobile app that the contacts sign into - that is not hosted on HubSpot. The contact updates their email address in your app/system, and your system verifies they own that email address through a confirmation email. That is when it is safe to update the member_email
property to be the same as the email
property you are updating for the contact.
If you have a public app and want to allow your users to choose whether to update member_email
in their HubSpot account without having to use your app's user interface, you can create a settings page within your app. This page can include a toggle control that allows users to turn the field update on or off as needed.
In the event a member contact wants to change their login email address. We encourage you to first verify that they own the email address, then update both their email and member_email
properties.
Questions or comments? Let's chat in the developer forums.