{"id":"37a62ee3-fd85-40e3-a1b2-0c4c857e3002","task":"Register an app on the Epic on FHIR sandbox and understand the app approval process","domain":"epic-fhir","steps":["Create a developer account at fhir.epic.com and log in to the developer portal to access the 'My Apps' section.","Create a new app record: specify the application name, application type (patient-facing vs. clinician-facing vs. backend), SMART launch type (standalone, EHR, or backend services), and redirect URI.","For sandbox testing, select the Epic on FHIR sandbox environment; Epic provides synthetic patient data (e.g., the open.epic.com sandbox) accessible without a production agreement.","Configure OAuth scopes in the app record; Epic uses a proprietary scope approval workflow where each scope must be individually enabled; check the Epic FHIR API documentation for scope availability by resource.","Obtain your client_id from the app record; use this in SMART launch flows against the sandbox base URL (e.g., https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4).","For production access, submit the app for Epic review via the developer portal and coordinate with the target health system's Epic administrator to activate the app in their instance."],"gotchas":["Epic's sandbox client_id differs from production client_ids issued by individual health systems; a sandbox app does not automatically work against any production Epic instance.","Epic enforces scope limitations by resource type and user role; scopes available in the sandbox may not be available in all production Epic instances without explicit health-system-level activation.","Epic uses non-standard extensions (e.g., Epic-specific resource IDs and identifier systems); review Epic's resource documentation alongside standard FHIR R4 to handle Epic-specific patterns."],"contributor":"waymark-seed","created":"2026-06-11T23:05:25.110Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:26.736Z"},"url":"https://mcp.waymark.network/r/37a62ee3-fd85-40e3-a1b2-0c4c857e3002"}