Skip to content
Suggest a correction

Record Health Check Result event fields

Reference4 min read

Look up every field of the Record Health Check Result Platform Event, which reports the status, severity, and Reason Code of one Check for one record after a run. Use it when receiving automation must know which Check failed; use the Set Run event when counts are enough.

PropertyValue
LabelRecord Health Check Result
API name in your orgrhc__Record_Health_Check_Result__e
Event typeHigh Volume
Publish behaviorPublish After Commit
Contract Version1.0

To save or route these events with Flow or Apex, see Save or route individual Check results.

The run starts fromResult events publish
A person selecting Run or Rerun on the cardOne for each Check with Publish User Result Event selected, whatever its status.
A Flow action, Apex code, or an async jobWith ACTIONABLE, one for each FAIL, UNABLE_TO_EVALUATE, or ERROR result. With ALL, one for every result.

Page loads, browser refreshes, the automatic rerun after a save, Agentforce actions, the MCP service, and Preview never publish. See Decide when to use Platform Events for every rule.

Salesforce delivers the event only after the transaction that ran the Checks completes. When that transaction rolls back, the event is discarded.

Field labelAPI name in your orgTypeValue
Event IDrhc__EventId__cText(80), requiredA different value for every event. Save it in a Unique field to detect a repeated event.
Run IDrhc__RunId__cText(120), requiredThe run’s ID, shared with the run’s Set Run events.
Check Set Qualified API Namerhc__CheckSetQualifiedApiName__cText(80), requiredThe Check Set the Check belongs to.
Check Qualified API Namerhc__CheckQualifiedApiName__cText(80), requiredThe Check that produced the result.
Record IDrhc__RecordId__cText(18)The record that was checked.
Statusrhc__Status__cText(30), requiredPASS, FAIL, SKIPPED, UNABLE_TO_EVALUATE, or ERROR.
Severityrhc__Severity__cText(20)The Check’s Failure Severity, CRITICAL, WARNING, or INFO, when Status is FAIL.
Reason Coderhc__ReasonCode__cText(80)A code that explains the result, such as PREREQUISITE_NOT_MET. Can be blank, for example on a formula FAIL.
Sourcerhc__Source__cText(30), requiredWhat started the run: USER_INITIATED (a person selected Run on the card), FLOW, APEX_API, QUEUEABLE, BATCH, or SCHEDULED from the package’s entry points. Apex that sets an origin with withExecutionOrigin(...) can also produce FUTURE or any other execution origin.
Occurred Atrhc__OccurredAt__cDate/Time, requiredWhen the event was created.
Contract Versionrhc__ContractVersion__cText(10), required1.0.
Framework Versionrhc__FrameworkVersion__cText(20), required2.0.11.
Contains Restricted Detailrhc__ContainsRestrictedDetail__cCheckboxAlways false in contract version 1.0. The event never contains restricted details.

The event contains no messages, Found or Expected values, formulas, queries, field values, or user ID. Route on Status, Reason Code, Severity, and Check Qualified API Name; never on card text, which an administrator can change. See Reason codes for every Reason Code.

StatusMeaningTypical receiving action
PASSThe record meets the Check’s requirement.Save for history, or ignore.
FAILThe record does not meet the requirement.Create follow-up work for a business user.
SKIPPEDThe Check did not apply to the record, or its Prerequisite Check did not pass.Save for history, or ignore.
UNABLE_TO_EVALUATEAccess, configuration, or missing data prevented a reliable answer.Route to an administrator with the Reason Code.
ERRORAn unexpected problem stopped the Check.Route for technical investigation.
{
"rhc__EventId__c": "rhc-api-1791387000000-9f2c41d07a3b4c6e8d15f0a-2-4e8a0c2d9b7f41a3e6c5d8b0a1f29374",
"rhc__RunId__c": "rhc-api-1791387000000-9f2c41d07a3b4c6e8d15f0a2b7c94e31",
"rhc__CheckSetQualifiedApiName__c": "Account_Data_Quality",
"rhc__CheckQualifiedApiName__c": "Billing_City_Is_Populated",
"rhc__RecordId__c": "001000000000001AAA",
"rhc__Status__c": "FAIL",
"rhc__Severity__c": "WARNING",
"rhc__ReasonCode__c": null,
"rhc__Source__c": "FLOW",
"rhc__OccurredAt__c": "2026-10-07T15:30:00.000Z",
"rhc__ContractVersion__c": "1.0",
"rhc__FrameworkVersion__c": "2.0.11",
"rhc__ContainsRestrictedDetail__c": false
}

The IDs, names, and time are examples. Check Sets and Checks created in the org have no prefix; an installed example has one, such as rhc__Example_Website_URL_Valid.

An event with Source USER_INITIATED reports a status that the browser evaluated. Salesforce keeps only results for the record on the page and for Checks in the Check Set, but does not evaluate the Check again. Before a change that affects security, compliance, or money, run the Check again from Apex or Flow.

The Record Health Check Card User, Record Health Check User, and Record Health Check Admin permission sets grant Create and Read access to this event. Receiving automation needs Read access, plus access to any object it writes to.

The event names a Salesforce record. Protect saved copies as you protect that record.