January 21, 2025
To help you manage user profiles more effectively, we've introduced the Merge Users API. This API lets you combine two Iterable user profiles into one, including system events, custom events, and user profile fields. This is a key update that represents a significant enhancement to Iterable's user profile management capabilities and can help you keep your user data clean and up-to-date.
The new endpoint, POST /api/users/merge, accepts a source user identifier and a destination user identifier as parameters in the request body. It merges the source user data into the destination user profile and deletes the source user profile. If the destination user doesn't yet exist, Iterable simply changes the identifier on the source user profile. Additionally, Iterable provides functionality to specify how to merge array data for user profile fields.
To learn more about how the Merge Users API works, see Merging User Profiles.