--- schema_version: "1" id: 5912165f1569f6740dcf2b98918bc6beeef98d59d70d4f5408ca9efc1741344f title: Clinical Data Model collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/health_cloud_object_reference/hc_clinical_data_model.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_clinical_data_model.htm source_site: developer.salesforce.com content_type: documentation content_hash: f4d03186f87f677c88e6d4846634012038913e98fe2c43e2a2419325215ad7bc description: Patient data and healthcare records are important in the healthcare industry. Without accurate information, performing and managing care becomes difficult. These records are readily available if a patient seeks care from the same provider every time. However, in reality, a patient’s healthcare journey takes them to multiple providers and hospitals at different times. Because the patient’s health hinges on the accuracy of their medical records, it’s crucial for the systems used by different providers and hospitals to be interoperable. And to make this interoperability possible, it’s vital to have some industry-recognized standards for how these records are structured, stored, and transferred. That’s where the standards defined by Health Level 7 (HL7) come in. --- # Clinical Data Model Patient data and healthcare records are important in the healthcare industry. Without accurate information, performing and managing care becomes difficult. These records are readily available if a patient seeks care from the same provider every time. However, in reality, a patient’s healthcare journey takes them to multiple providers and hospitals at different times. Because the patient’s health hinges on the accuracy of their medical records, it’s crucial for the systems used by different providers and hospitals to be interoperable. And to make this interoperability possible, it’s vital to have some industry-recognized standards for how these records are structured, stored, and transferred. That’s where the standards defined by Health Level 7 (HL7) come in.
Available in: Enterprise and Unlimited Editions
Two standards defined by HL7 for this purpose are the Fast Health Interoperability Resources (FHIR) v4.0 and HL7 (the standard) 2.3. The Clinical Data Model is built from the ground up to align with FHIR v4.0, and also supports many of the HL7 v2.3 message types. To enable these objects in your org, go to **FHIR R4 Support Settings** in **Setup** and enable the **FHIR-Aligned Clinical Data Model** org pref. ![Note](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/images/icon_note.png) #### Note Some of these objects are available in your org even before enabling this org pref because they’re part of other data models in Health Cloud and Life Sciences Cloud. ![Note](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/images/icon_note.png) #### Note To use the Clinical Data Model objects on an Experience Cloud site, community users need the FHIR R4 for Experience Cloud Sites permission set. Here’s the list of objects that need the org pref to be enabled versus a list of objects that don’t require the org pref.
Org Pref Required Org Pref Not Required
  • AllergyIntolerance
  • CarePerformer
  • ClinicalAlert
  • ClinicalEncounter
  • ClinicalEncounterDiagnosis
  • ClinicalEncounterFacility
  • ClinicalEncounterIdentifier
  • ClinicalEncounterProvider
  • ClinicalEncounterReason
  • ClinicalEncounterSvcRequest
  • ClinicalServiceRequest
  • ClinicalServiceRequestDetail
  • DiagnosticSummary
  • HealthCondition
  • MedicationRequest
  • MedicationStatement
  • PatientHealthReaction
  • PatientImmunization
  • PatientMedicalProcedure
  • PatientMedicalProcedureDetail
  • PatientMedicationDosage
  • CareObservation
  • CareObservationComponent
  • CareObservationDetail
  • CareProviderFacilitySpecialty
  • CodeSet
  • CodeSetBundle
  • HealthcareFacility
  • HealthcarePractitionerFacility
  • HealthcareProvider
  • HealthPlanFacilityNetwork
  • HealthPlanFormularyItem
  • Identifier
  • Medication
  • Medication Administration
  • Medication Administration Detail
  • OpportunityProductCategory
  • PersonLanguage
  • PersonName
  • Problem Definition Relationship
  • Specimen
And here’s the list of fields added to standard objects when you enable this org pref. - ContactPointPhone.PreferenceRank - ContactPointPhone.UsageType - ContactPointEmail.PreferenceRank - ContactPointEmail.UsageType - ContactPointAddress.PreferenceRank - ContactPointAddress.UsageType - Account.IsActive - Account.EffectiveDate - Account.SourceSystemIdentifier - Account.SourceSystemModifiedDate - Account.EndDate - Contact.MaritalStatus - Contact.Gender - Contact.DeceasedDate - Contact.SequenceInMultipleBirth ![Note](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/images/icon_note.png) #### Note - Starting with the Spring ’23 release, new customers won’t be able to create records in the packaged EHR objects that have counterpart standard objects in the FHIR R4-aligned data model. - All future development will be built on the FHIR R4-aligned data model. The packaged objects in the EHR data model won’t be used for future development. - **[ActivityTiming](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_activitytiming.htm)** Represents detailed information about an activity that’s repeated in regular intervals over a period of time. This object is available in API version 52.0 and later. - **[AllergyIntolerance](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_AllergyIntolerance.htm)** Represents a clinical assessment of a patient’s allergy or intolerance. This object is available in API version 51.0 and later. - **[AuthorNote](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_authornote.htm)** Stores notes associated with different types of records along with information about the author of the note and the time the note was authored. The author isn’t necessarily the person who created a record. The author is the person who provided the information in the note. This object is available in API version 52.0 and later. - **[CareObservation](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_CareObservation.htm)** Represents the observed values for care metrics originating from external systems that contain biometric data. This object is available in API version 49.0 and later. - **[CarePerformer](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_CarePerformer.htm)** Represents the person performing care in observations, procedure, and immunizations. This person may be a physician, the patient’s contact, or anyone who administered any sort of care to the patient in the context of the concerned care event. This object is available in API version 51.0 and later. - **[CareRegisteredDevice](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_careregistereddevice.htm)** Represents a device or device registration information for a patient or a care program enrollee. This object is available in API version 49.0 and later. - **[DiagnosticSummary](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_DiagnosticSummary.htm)** Represents the findings, interpretations, and summaries of tests performed on patients. This object is available in API version 51.0 and later. - **[ClinicalAlert](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_ClinicalAlert.htm)** Represents a warning or notification of significance related to different healthcare entities. The subject of the alert may be a patient, a location, a provider, a procedure, or even a medication. This object is available in API version 51.0 and later. - **[ClinicalDetectedIssue](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_ClinicalDetectedIssue.htm)** Represents information about a detected issue resulting from a clinical activity. This object is available in API version 55.0 and later. - **[ClinicalDetectedIssueDetail](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_ClinicalDetectedIssueDetail.htm)** Represents additional information about a clinical detected issue. This object is available in API version 55.0 and later. - **[ClinicalEncounter](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_ClinicalEncounter.htm)** Represents a healthcare related encounter of a patient with a care provider. This is a broad object that covers multiple phases of a patient’s healthcare service experience, all the way from pre-admission to stay to discharge, and everything in between. This object is available in API version 51.0 and later. - **[ClinicalServiceRequest](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_ClinicalServicerequest.htm)** Represents requests for a procedure or diagnostic service that needs to be planned, proposed, or performed as part of the patient’s healthcare. This object is available in API version 51.0 and later. - **[CodeSet](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_CodeSet.htm)** Represents various industry defined codes in the context of their systems and versions of those systems. These codes are used in all sorts of digital records. This object is available in API version 50.0 and later. - **[CodeSetBundle](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_CodeSetBundle.htm)** Represents a group of code sets across multiple systems and versions. All of these code sets refer to the same conceptual entity. This object is available in API version 50.0 and later. - **[ContactProfile](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_contactprofile.htm)** Represents information about an individual, such as their ethnicity, citizenship, birth place, race, and so on. This object is available in API version 57.0 and later. - **[HealthcareFacility](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_HealthCareFacility.htm)** Represents a healthcare facility and all its related details. These details may be physical, functional, geographic, or business details. This object is available in API version 51.0 and later. - **[HealthCondition](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_HealthCondition.htm)** Represents a clinical condition, problem, or any clinically relevant occurrence that is a matter of concern. This object is available in API version 51.0 and later. - **[HealthPlanFacilityNetwork](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/sforce_api_objects_healthplanfacilitynetwork.htm)** Represents the association between an insurance product or plan and a designated healthcare facility network. This entity is fundamental in healthcare management, allowing insurers and providers to accurately determine which facilities are in-network for a given patient's plan, facilitating eligibility checks and service coordination. This object is available in API version 68.0 and later. - **[HealthPlanFormularyItem](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/sforce_api_objects_healthplanformularyitem.htm)** Represents which drugs, medical devices, or services are covered under specific insurance products within defined time periods. Each record establishes a relationship between Product2 insurance plans and FormularyItem records. This object is available in API version 68.0 and later. - **[HealthRiskEvaluation](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_healthriskevaluation.htm)** Represents the evaluation of health risks. This object is available in API version 64.0 and later. - **[HealthRiskEvalDetail](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_healthriskevaldetail.htm)** Represents additional details of a health risk evaluation, including the basis and reason for the evaluation. This object is available in API version 64.0 and later. - **[HealthRiskEvalOutcome](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_healthriskevaloutcome.htm)** Represents the outcome of a risk evaluation, such as the probability of disease occurrence. This object is available in API version 64.0 and later. - **[Identifier](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_Identifier.htm)** Represents identifier information for multiple objects. This object is available in API version 51.0 and later. - **[Medication](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_Medication.htm)** Represents detailed information about different medications. This object is available in API version 51.0 and later. - **[MedicationAdministration](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_objects_medicationadministration.htm)** Represents an instance of medication administered to a patient. This object is available in API version 64.0 and later. - **[MedicationDispense](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_medicationdispense.htm)** Represents the dispense of a medication to a patient in response to a medication request or order. This object also includes the instructions for how the medication is to be administered This object is available in API version 54.0 and later. - **[MedicationRequest](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_MedicationRequest.htm)** Represents a request or order for the supply of medication, along with information about how it should be administered. This object is available in API version 51.0 and later. - **[MedicationStatement](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_MedicationStatement.htm)** Represents a record of medication that the patient is currently taking or has taken in the past. This object is available in API version 51.0 and later. - **[OpportunityProductCategory](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/sforce_api_objects_opportunityproductcategory.htm)** Represents the junction between an Opportunity and the specific Medicare product categories the beneficiary has authorized for discussion. Each record represents one Medicare Part (e.g., Part A, Part C, Part D) included in the scope. This object is available in API version 68.0 and later. - **[PatientHealthReaction](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_PatientHealthReaction.htm)** Represents a patient’s adverse reaction to an allergy, intolerance, or immunization. This object is available in API version 51.0 and later. - **[PatientImmunization](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_PatientImmunization.htm)** Represents information about a patient’s immunizations. This object is available in API version 51.0 and later. - **[PatientMedicalProcedure](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_patientmedicalprocedure.htm)** Represents detailed information about a healthcare procedure the patient has undergone, is undergoing or will undergo. This object is available in API version 51.0 and later. - **[PatientMedicationDosage](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_PatientMedicationDosage.htm)** Represents dosage information for medication. This object is primarily used to add dosage information in MedicationStatement, MedicationRequest, or MedicationDispense records. This object is available in API version 51.0 and later. - **[PersonLanguage](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_PersonLanguage.htm)** Represents the use and preference information about a person’s language. This object is available in API version 51.0 and later. - **[PersonName](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_PersonName.htm)** Represents detailed information about a person’s name. This object is available in API version 51.0 and later. - **[ProblemDefRelationship](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_objects_problemdefrelationship.htm)** Represents a junction between a problem definition and a related problem definition. This object is available in API version 64.0 and later. - **[Specimen](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_objects_specimen.htm)** Represents a sample used for analysis. This object is available in API version 64.0 and later. #### See Also - [Mapping FHIR v4.0 to Salesforce Standard Objects](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/map_fhir_overview.htm "The Fast Health Interoperability Resources (FHIR) standard defined by Health Level Seven (HL7) enables healthcare systems to work seamlessly together enhancing their interoperability. The Clinical Data Model is built to align with HL7’s FHIR R4. However, because of the way the Salesforce platform works, the Salesforce implementation of FHIR R4 isn’t identical to how it’s defined by HL7. Here’s how various FHIR resources map to fields in different standard objects in Salesforce.")