How to Create a FHIR Subscription in AWS HealthLake

Details

This document serves as a technical implementation guide for the FHIR Subscription feature within AWS HealthLake. Users must first create a `SubscriptionTopic` resource, defining the resource type and triggers to monitor (e.g., creation or update of an Encounter). Two primary notification methods are supported: REST Hooks and EventBridge. When using REST Hooks, proper setup is required for OAuth authentication, including passing client-id, client-secret, and oAuth-endpoint-url. When utilizing EventBridge, users must configure resource policies to trust the service principal `healthlake.amazonaws.com` and establish rules that match events generated by HealthLake (e.g., `detail-type`: ["FHIR Subscription Notification"]). These detailed steps enable real-time detection and integration of healthcare data events, which is crucial for building advanced interoperable healthcare systems. The process involves defining the subscription resource with a status of "requested", referencing the topic ID, and setting filter conditions.