Health Gorilla’s platform uses FHIR Subscriptions to enable webhook-based notifications for real-time clinical event delivery. This allows client applications to receive immediate alerts when new data becomes available—such as completed encounters, updated documents, or lab results—without polling the API.
Webhooks are the preferred method for event-driven integrations and are supported across both FHIR R4 and STU3. They provide low-latency delivery of clinical updates and reduce the need for repetitive API calls. Polling is supported as a fallback option but should only be used when webhook delivery is not feasible.
This guide includes:
- How to register and manage FHIR Subscriptions
- Supported event types and resource criteria
- Webhook delivery formats, headers, and security expectations
- Sample webhook payloads by resource type
- Retry behavior, failure handling, and idempotency strategies
- Polling recommendations as a last-resort alternative