Change Data Capture Developer Guide
Summer '26 (API version 67.0)
Spring '26 (API version 66.0)
Winter '26 (API version 65.0)
Summer '25 (API version 64.0)
Spring '25 (API version 63.0)
Winter '25 (API version 62.0)
Summer '24 (API version 61.0)
Spring '24 (API version 60.0)
Winter '24 (API version 59.0)
Summer '23 (API version 58.0)
Spring '23 (API version 57.0)
Winter '23 (API version 56.0)
Summer '22 (API version 55.0)
Spring '22 (API version 54.0)
Winter '22 (API version 53.0)
Summer '21 (API version 52.0)
Spring '21 (API version 51.0)
Winter '21 (API version 50.0)
Summer '20 (API version 49.0)
Spring '20 (API version 48.0)
Winter '20 (API version 47.0)
Summer '19 (API version 46.0)
Spring '19 (API version 45.0)
Winter '19 (API version 44.0)
Merged Change Events
Monitor Change Event Publishing and Delivery Usage
Creating and Undeleting a Person Account
Updating a Person Account
Converting an Account
Deleting a Person Account
Change Events for Users
Change Events for Lead Conversion
Change Events for PricebookEntry
Change Events for Person Accounts
Because a person account record combines fields from an account and a contact, changing
a person account results in two change events: one for the account and one for the contact,
provided that both objects are selected for change data capture. The two change events are
generated for all changes to a person account, including create, update, delete, and undelete
operations.
To receive change events for person account records, enable both Account and Contact for change data capture. If only Account is selected and a person account is updated, the account change event doesn’t contain the fields that stem from the contact. Examples of such fields are PersonAssistantName, which corresponds to the contact AssistantName field, or a contact custom field. This behavior doesn’t apply when creating or undeleting a person account—the account change event contains the contact fields even if Contact isn’t selected for capture.
Note
-
Creating and Undeleting a Person Account
When creating or undeleting a person account, the account change event contains both account and contact fields. It contains account record fields and some fields from the contact record. The contact fields that the account change event includes are all custom contact fields and some standard contact fields, which start with the Person prefix. -
Updating a Person Account
When updating a person account, two change events are generated, one for the account and one for the contact, regardless which fields changed. Salesforce always updates the LastModifiedDate system field in both the account and contact even if the field updated is only in one of the underlying records. -
Converting an Account
If a person account is converted to a business account through the API by modifying the record type ID, a change event for the account is generated. This change event contains the new record type ID of the account. -
Deleting a Person Account
When deleting a person account, two change events are generated: one for the deleted account and one for the deleted contact. The change events don’t contain record fields. They contain only event header fields.