Record Health Check Result event fields
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.
| Property | Value |
|---|---|
| Label | Record Health Check Result |
| API name in your org | rhc_ |
| Event type | High Volume |
| Publish behavior | Publish After Commit |
| Contract Version | 1. |
To save or route these events with Flow or Apex, see Save or route individual Check results.
When it publishes
Section titled “When it publishes”| The run starts from | Result events publish |
|---|---|
| A person selecting Run or Rerun on the card | One for each Check with Publish User Result Event selected, whatever its status. |
| A Flow action, Apex code, or an async job | With ACTIONABLE, one for each FAIL, UNABLE_, 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.
Fields
Section titled “Fields”| Field label | API name in your org | Type | Value |
|---|---|---|---|
| Event ID | rhc_ | Text(80), required | A different value for every event. Save it in a Unique field to detect a repeated event. |
| Run ID | rhc_ | Text(120), required | The run’s ID, shared with the run’s Set Run events. |
| Check Set Qualified API Name | rhc_ | Text(80), required | The Check Set the Check belongs to. |
| Check Qualified API Name | rhc_ | Text(80), required | The Check that produced the result. |
| Record ID | rhc_ | Text(18) | The record that was checked. |
| Status | rhc_ | Text(30), required | PASS, FAIL, SKIPPED, UNABLE_, or ERROR. |
| Severity | rhc_ | Text(20) | The Check’s Failure Severity, CRITICAL, WARNING, or INFO, when Status is FAIL. |
| Reason Code | rhc_ | Text(80) | A code that explains the result, such as PREREQUISITE_. Can be blank, for example on a formula FAIL. |
| Source | rhc_ | Text(30), required | What started the run: USER_ (a person selected Run on the card), FLOW, APEX_, 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 At | rhc_ | Date/Time, required | When the event was created. |
| Contract Version | rhc_ | Text(10), required | 1.. |
| Framework Version | rhc_ | Text(20), required | 2.. |
| Contains Restricted Detail | rhc_ | Checkbox | Always false in contract version 1.. 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.
What each status means
Section titled “What each status means”| Status | Meaning | Typical receiving action |
|---|---|---|
PASS | The record meets the Check’s requirement. | Save for history, or ignore. |
FAIL | The record does not meet the requirement. | Create follow-up work for a business user. |
SKIPPED | The Check did not apply to the record, or its Prerequisite Check did not pass. | Save for history, or ignore. |
UNABLE_ | Access, configuration, or missing data prevented a reliable answer. | Route to an administrator with the Reason Code. |
ERROR | An unexpected problem stopped the Check. | Route for technical investigation. |
Example event
Section titled “Example event”{ "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.
Card events are reported by the browser
Section titled “Card events are reported by the browser”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.
Access
Section titled “Access”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.