Epic Integration
Clinical workflow patterns, order lifecycle, and care coordination metrics.
Overview
Connect Epic EHR to analyze clinical workflow patterns — order lifecycle, care coordination handoffs, and documentation cadence. Corvana maps operational workflows without accessing protected health information (PHI).
Prerequisites
- Epic admin access with FHIR API permissions
- Corvana Assess account with healthcare module
- BAA (Business Associate Agreement) executed with Corvana
OAuth Scopes
Corvana requests the minimum necessary permissions — always read-only. The following scopes are requested during the OAuth authorization flow:
| Scope | Access Level |
|---|---|
read (FHIR R4) | Read-only |
Data We Collect
Corvana collects only structural metadata — never content, PII, or sensitive data. The following data points are analyzed:
- Order status transitions (anonymized)
- Care team coordination timestamps
- Department handoff patterns
- Documentation completion cadence
- Scheduling utilization rates
Data We Never Collect
To protect your privacy and security, the following data is explicitly excluded from collection:
- Never: Patient names or identifiers
- Never: Clinical notes or diagnoses
- Never: Lab results or imaging
- Never: Medication details
- Never: Insurance information
Setup Steps
Step 1: Navigate to Integrations
From your Corvana Assess dashboard, open the left sidebar and click Integrations.
Step 2: Connect Epic
Find the Epic card and click Connect Epic. This initiates the OAuth flow.
Step 3: Authorize Access
Review the requested permissions on Epic's authorization page and click Allow. Corvana requests read-only access only.
Step 4: Verify Connection
Return to the Corvana dashboard. The Epic card should now show "Connected" with a green indicator. Data collection begins within minutes.
Disconnecting
You can disconnect Epic at any time from the Integrations dashboard. Click the connected Epic card and select Disconnect. All collected metadata is permanently deleted within 24 hours. You can also revoke access directly from Epic's admin panel.
Troubleshooting
The Epic connection shows "Disconnected"
Try reconnecting from the Integrations dashboard. If the issue persists, check that your Epic admin has not revoked the OAuth authorization.
I don't see any data after connecting
Data collection typically begins within 5-10 minutes. If no data appears after 30 minutes, check your connection status and ensure the account has the required permissions.