Developer Announcements

Dadams
HubSpot Employee
HubSpot Employee

Updated merge functionality for contacts and companies

What's changing?

We're making changes to how merges are handled for contact and company records to make them more consistent with merges for other object types.

 

Currently, when contacts or companies are merged, the record ID of the primary record is used for the resulting merged record. Going forward, a new record with a new ID will be created for the resulting merged record, with both records merged into the new one. Similar to the previous merge functionality, both of the previous IDs will point to the resulting merged record, so fetching any records using the original IDs will return the new merged record with the new ID. If you work with contact or company records, you will want to make sure you handle the case where an existing record ID can return a new merged record ID.

 

Previously, the value for any property would be determined by the most recent timestamp for the latest update to that property from the merged records. With the new behavior, the property values of the resulting merged record will use the latest property values of the primary record as the current value. Property values from both objects will still be merged onto the new object.

 

Previously, contact merges with property values with the same name and timestamp from both records would have their timestamps adjusted. This will no longer happen, and only values from the primary will be kept.

 

Note: Contact and company properties that already have exceptions to existing behavior as detailed in our help documentation for merging records will keep their special behavior.

 

Additionally, associations from the primary record will be prioritized for the resulting merged record. When there are multiple associations with "primary" labels for the same object type, the merged record will prioritize associations from the primary record, and excess "primary" associations from secondary records will be dropped.

 

Why is this changing?

These changes bring contacts and companies in line with the merge functionality of other CRM objects, so that merges for all objects will work in a similar way. In addition to making it easier to handle merges for all objects, this also makes it easier to add new options for record merges in the future.

 

When is this changing?

The new merge functionality will begin affecting new merges beginning on January 14th, 2025. This change will only affect records merged after this update, and existing records that have been merged will not be changed.

*Important note: This functionality was originally planned to be released on October 21, 2024, but since October 2, 2024, we've extended this date to January 14th, 2025.

 

Please let us know if you have any questions by replying below.

2 Antworten
hseligson
HubSpot Employee
HubSpot Employee

Updated merge functionality for contacts and companies

Hello Developer Community,
This changelog has been superseded by an updated version published on October 2, 2024. Please refer to the new changelog and community post for the most accurate and up-to-date information regarding merge functionality for contacts, companies, and other CRM objects. The previous version may have caused confusion about the scope of the changes.

Thank you! 
HubSpot, Developer Relations

Jnix284
Berühmtheit

Updated merge functionality for contacts and companies

Thank you @Dadams - with this change, would it be possible to restore previously merged records since the original IDs would both be retained?


If my reply answered your question please mark it as a solution to make it easier for others to find.


Jennifer Nixon