Notifications are published as POST /<webhook-url> requests.

Individual notifications are published for CREATE, UPDATE, and DELETE golden record events.

Golden Record Merges

For golden record merges, 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.

Additionally, the notification payload includes meta data for this event, including the surviving record ID and retired record ID.

Golden Record Unmerges

For golden record unmerges, two UPDATE events are published: one for the retained record and one for the previously retired (resurrected) 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.

Additionally, the notification payload includes meta data for this event, including the retained record ID and resurrected record ID.