CRM properties tell you the current state of a given object, like a contact, what their first name is, what their address is and so on. One thing they can also tell you is what those values used to be. Maybe they moved so you changed their address. Sometimes, you need to know who or what made those changes in the case of an audit or simply correcting a mistake. Our API allows you to request the history of a property along with who or what made the change.
What’s happening
Currently, when the change was made in the HubSpot app, the "source-id" field will be the user’s email address. Starting April 26th, this changes to be the user's Id. You can still get the email address of the user by making an API call to the Owners API. This a breaking change that will require an update to your code if your integration expects this value to be the actual email address.
The exact format of the field will be {userId:123} where 123 is the ID of the user you can supply to the Owners API. If you are relying on this information, we strongly suggest you add a conditional to check the format of this field in order to prepare for this change.
Why are we making this change?
This means the data will always be accurate even if a user changes their email address or requests us to remove them under a privacy regulation request.
If you have any comments or questions, join the discussion in the community.