Search
K
< Back

Patient Enrollment

ADT Notifications are generated only for patients who are actively enrolled at the time an HL7 ADT message is processed. Enrollment applies specifically to ADT Notifications and determines whether an HL7 ADT message will generate a notification for the patient. You must enroll patients before notification delivery begins.

Enrollment ensures that ADT Notifications are delivered for the appropriate patient cohort and prevents notifications from being generated for patients who should not be monitored.

Enrollment Requirements

To be eligible for ADT Notifications, a patient must:

  • Be actively enrolled at the time the HL7 ADT message is processed
  • Be associated with a practice or tenant that is licensed for ADT Notifications
  • Have a valid patient identity in Health Gorilla

Enrollment Methods

You can enroll patients for ADT Notifications using one of the following methods.

FHIR Group API Enrollment

The FHIR Group API allows you to manage patient enrollment dynamically.

Use the following Group operations:

  • @add to enroll patients
  • @remove to unenroll patients
  • @lookup to check whether a patient is enrolled
  • @members to review the current list of enrolled patients

You should verify enrollment using @members before expecting notifications.

Roster Upload

For stable patient cohorts provided by attribution partners or external sources, you can submit a static roster for enrollment.

  • Prepare the roster file according to Health Gorilla specifications (fixed-width format or CSV)
  • Upload the file using SFTP
  • After the upload, request confirmation from Health Gorilla Support that the roster was ingested successfully

Enrollment Behavior

Enrollment status determines whether an ADT Notification is generated when an HL7 ADT message is processed.

  • No notification is generated if the patient is not enrolled at the time the message is processed
  • No retroactive notification is generated if the patient is enrolled after the original message was sent
  • No further notifications are generated if the patient is removed from enrollment

To ensure that ADT Notifications are generated as expected, it is important to maintain accurate and timely enrollment lists.