/webhooks/v1alpha1/recordEvents

Tamr’s event-driven notification system enables you to keep all of your systems up to date with the golden records in the Tamr System of Record (SOR).

Tamr can publish notifications for these logical record events to a user-specified endpoint (a webhook):

  • Create golden record
  • Update golden record
  • Delete golden record
  • Merge golden record
  • Unmerge golden record
  • Enrich golden record

Merge and Unmerge Logical Actions

For golden record merge actions, an UPDATE event is published to update the data in the surviving golden record. A DELETE event is sent for the retired golden record. These two physical events are grouped together as one logical event by the same versionId value. They are ordered by two different values for recordNumber.

For golden record unmerge actions, an UPDATE event is published to update the data in the surviving golden record. A CREATE event is sent for the previously retired (resurrected) record golden record. These two physical events are grouped together as one logical event by the same versionId value. They are ordered by two different values for recordNumber.

Example Webhook Events

© 2025, Tamr, Inc. All rights reserved.

License Agreement | Privacy Policy | Data Security Policy| AI Chatbot Disclaimer

Logical Action Webhook Record Event
versionId changeType recordNumber newData
Create Record 12355 CREATE 0 The record data of the created record.
Update Record 23435 UPDATE 0 The new record data resulting from the update record action.
Delete Record 33256 DELETE 0 Empty object.
Merge Record 44566 UPDATE 0 The new record data of the surviving record.
DELETE 1 Empty object. The retiring record has been deleted.
Unmerge Record 54536 UPDATE 0 The new record data of the retained record.
CREATE 1 The new record data of the resurrected record.