Health Gorilla’s platform uses FHIR subscriptions to enable webhook notifications for timely clinical event delivery. This allows your system to receive notifications when new data—such as completed encounters, updated documents, or lab results—becomes available 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, asynchronous 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