> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# Epic connector

- Connector: `appmixer.epic`
- Version: 1.1.2
- Components: 25 (3 triggers, 22 actions)

Read clinical data from Epic on FHIR (R4): patients, conditions, observations (labs, vitals, smoking history), medications, procedures, immunizations, diagnostic reports, documents and more.

- Connector page: <https://connectors.appmixer.com/connector/appmixer.epic/1.1.2>
- Documentation: <https://docs.appmixer.com/connector-configuration/epic>
- Source code: <https://github.com/clientIO/appmixer-connectors/tree/dev/src/appmixer/epic>
- Download package: <https://connectors.appmixer.com/connector/appmixer.epic/1.1.2/download>

## Authentication

**Type:** OAuth 2

## Triggers (3)

- [New Appointment](https://connectors.appmixer.com/connector/appmixer.epic/1.1.2/component/appmixer.epic.core.NewAppointment.md) (`appmixer.epic.core.NewAppointment`): Triggers when a new appointment is created for a patient in Epic. Emits all available appointment data.
- [Updated Appointment](https://connectors.appmixer.com/connector/appmixer.epic/1.1.2/component/appmixer.epic.core.UpdatedAppointment.md) (`appmixer.epic.core.UpdatedAppointment`): Triggers when an appointment of a patient is updated in Epic (time, status or other changes). Emits all available appointment data.
- [Cancelled Appointment](https://connectors.appmixer.com/connector/appmixer.epic/1.1.2/component/appmixer.epic.core.CancelledAppointment.md) (`appmixer.epic.core.CancelledAppointment`): Triggers when an appointment of a patient is cancelled in Epic. Emits all available appointment data.

## Actions (22)

- [Find Care Plans](https://connectors.appmixer.com/connector/appmixer.epic/1.1.2/component/appmixer.epic.core.FindCarePlans.md) (`appmixer.epic.core.FindCarePlans`): Retrieve the care plans recorded for a patient in Epic. Returns up to one page of results (Epic's default page size).
- [Find Conditions](https://connectors.appmixer.com/connector/appmixer.epic/1.1.2/component/appmixer.epic.core.FindConditions.md) (`appmixer.epic.core.FindConditions`): Retrieve the conditions (problems/diagnoses) recorded for a patient in Epic. Returns up to one page of results (Epic's default page size).
- [Find Devices](https://connectors.appmixer.com/connector/appmixer.epic/1.1.2/component/appmixer.epic.core.FindDevices.md) (`appmixer.epic.core.FindDevices`): Retrieve the devices (implants/equipment) associated with a patient in Epic. Returns up to one page of results (Epic's default page size).
- [Find Diagnostic Reports](https://connectors.appmixer.com/connector/appmixer.epic/1.1.2/component/appmixer.epic.core.FindDiagnosticReports.md) (`appmixer.epic.core.FindDiagnosticReports`): Retrieve the diagnostic reports (with full details) for a patient in Epic. Returns up to one page of results (Epic's default page size).
- [Find Documents](https://connectors.appmixer.com/connector/appmixer.epic/1.1.2/component/appmixer.epic.core.FindDocumentReferences.md) (`appmixer.epic.core.FindDocumentReferences`): Retrieve the document references (clinical documents) for a patient in Epic. Returns up to one page of results (Epic's default page size).
- [Find Goals](https://connectors.appmixer.com/connector/appmixer.epic/1.1.2/component/appmixer.epic.core.FindGoals.md) (`appmixer.epic.core.FindGoals`): Retrieve the goals recorded for a patient in Epic. Returns up to one page of results (Epic's default page size).
- [Find Immunizations](https://connectors.appmixer.com/connector/appmixer.epic/1.1.2/component/appmixer.epic.core.FindImmunizations.md) (`appmixer.epic.core.FindImmunizations`): Retrieve the immunization records for a patient in Epic. Returns up to one page of results (Epic's default page size).
- [Find Lab Results](https://connectors.appmixer.com/connector/appmixer.epic/1.1.2/component/appmixer.epic.core.FindLabResults.md) (`appmixer.epic.core.FindLabResults`): Retrieve laboratory observations (lab results) recorded for a patient in Epic. Returns up to one page of results (Epic's default page size).
- [Find Medication Requests](https://connectors.appmixer.com/connector/appmixer.epic/1.1.2/component/appmixer.epic.core.FindMedicationRequests.md) (`appmixer.epic.core.FindMedicationRequests`): Retrieve the medication orders (prescriptions) for a patient in Epic. Returns up to one page of results (Epic's default page size).
- [Find Patients](https://connectors.appmixer.com/connector/appmixer.epic/1.1.2/component/appmixer.epic.core.FindPatients.md) (`appmixer.epic.core.FindPatients`): Search for patients in Epic by demographics (name, birth date) or by an MRN/identifier. Provide at least one search criterion. Returns up to one page of results (Epic's default page size).
- [Find Procedures](https://connectors.appmixer.com/connector/appmixer.epic/1.1.2/component/appmixer.epic.core.FindProcedures.md) (`appmixer.epic.core.FindProcedures`): Retrieve the procedures performed for a patient in Epic. Returns up to one page of results (Epic's default page size).
- [Find Smoking History](https://connectors.appmixer.com/connector/appmixer.epic/1.1.2/component/appmixer.epic.core.FindSmokingHistory.md) (`appmixer.epic.core.FindSmokingHistory`): Retrieve social-history observations (including smoking/tobacco use history) recorded for a patient in Epic. Returns up to one page of results (Epic's default page size).
- [Find Vital Signs](https://connectors.appmixer.com/connector/appmixer.epic/1.1.2/component/appmixer.epic.core.FindVitalSigns.md) (`appmixer.epic.core.FindVitalSigns`): Retrieve vital-sign observations (e.g. blood pressure, heart rate, temperature) recorded for a patient in Epic. Returns up to one page of results (Epic's default page size).
- [Get Appointment](https://connectors.appmixer.com/connector/appmixer.epic/1.1.2/component/appmixer.epic.core.GetAppointment.md) (`appmixer.epic.core.GetAppointment`): Retrieve an appointment from Epic by its FHIR ID, including date, time, status, participants and all other available data.
- [Get Diagnostic Report](https://connectors.appmixer.com/connector/appmixer.epic/1.1.2/component/appmixer.epic.core.GetDiagnosticReport.md) (`appmixer.epic.core.GetDiagnosticReport`): Retrieve a single Diagnostic Report resource from Epic by its FHIR ID, including result references and attached report documents (presented form).
- [Get Condition](https://connectors.appmixer.com/connector/appmixer.epic/1.1.2/component/appmixer.epic.core.GetCondition.md) (`appmixer.epic.core.GetCondition`): Retrieve a single Condition resource (problem list item, diagnosis or health concern) from Epic by its FHIR ID, including its code, clinical and verification status, category and onset.
- [Get Document](https://connectors.appmixer.com/connector/appmixer.epic/1.1.2/component/appmixer.epic.core.GetDocumentReference.md) (`appmixer.epic.core.GetDocumentReference`): Retrieve a single DocumentReference resource (clinical note or document) from Epic by its FHIR ID, including its type, category, status, date and the attachment metadata pointing to the document content.
- [Get Medication](https://connectors.appmixer.com/connector/appmixer.epic/1.1.2/component/appmixer.epic.core.GetMedication.md) (`appmixer.epic.core.GetMedication`): Retrieve a single Medication resource from Epic by its FHIR ID. The Medication ID is typically taken from a Medication Request's medicationReference.
- [Get Medication Request](https://connectors.appmixer.com/connector/appmixer.epic/1.1.2/component/appmixer.epic.core.GetMedicationRequest.md) (`appmixer.epic.core.GetMedicationRequest`): Retrieve a single Medication Request (medication order) resource from Epic by its FHIR ID, including the ordered medication, requester and dosage instructions.
- [Get Patient](https://connectors.appmixer.com/connector/appmixer.epic/1.1.2/component/appmixer.epic.core.GetPatient.md) (`appmixer.epic.core.GetPatient`): Retrieve a single Patient resource from Epic by its FHIR ID. Returns patient demographics: name, identifiers, birth date, gender, contact details and address.
- [Get Procedure](https://connectors.appmixer.com/connector/appmixer.epic/1.1.2/component/appmixer.epic.core.GetProcedure.md) (`appmixer.epic.core.GetProcedure`): Retrieve a single Procedure resource from Epic by its FHIR ID, including the procedure code, status, category and when it was performed.
- [Make Api Call](https://connectors.appmixer.com/connector/appmixer.epic/1.1.2/component/appmixer.epic.core.MakeApiCall.md) (`appmixer.epic.core.MakeApiCall`): Performs an arbitrary authorized API call against the Epic FHIR R4 API. Additional scopes: `user/Patient.read`, `user/Condition.read`, `user/Observation.read`, `user/Medication.read`, `user/MedicationRequest.read`, `user/Procedure.read`, `user/CarePlan.read`, `user/Goal.read`, `user/Immunization.read`, `user/DiagnosticReport.read`, `user/DocumentReference.read`, `user/Device.read`, `user/Appointment.read`.

## Changelog

### 1.1.2

- Quote CSV cells that hold a comma, a double quote or a line break and map cells by header column when exporting results to a file.

### 1.1.1

- MakeApiCall: Request Headers and Query Parameters set in the Designer are now sent. They were silently dropped: the key-value field stores its rows as a JSON object string, which the component did not parse.

### 1.1.0

- New Get Condition and Get Document components: retrieve a single Condition or DocumentReference resource by its FHIR ID. Both use scopes the connector already requests, so existing accounts keep working without re-authentication.
- All Find and Get components: nested output field labels now use the Parent.Leaf form (e.g. "Code.Text", "Subject.Reference"), so Get and Find of the same resource show identical labels and same-named fields stay distinguishable in the variable picker. Labels only — variable paths are unchanged.
- Internal: Find components export their item schema as ITEM_SCHEMA, so the output contract is checked by the validator and usable by live verification.

### 1.0.2

- Fixed a crash when a Find/List component saved an EMPTY result set to a CSV file — the header row was built from the first record without checking there was one, so a search that legitimately matched nothing failed the flow instead of writing an empty file.

### 1.0.1

- Production readiness: OAuth2 authorize/token endpoints are now configurable per organisation. Set epicOauthBaseUrl explicitly, or let it derive from epicFhirBaseUrl (standard Epic interconnect layout); the public sandbox remains the default. The OAuth audience (aud) now follows the configured FHIR base URL.
- Internal: shared utilities consolidated into lib.js (commons.js removed) to follow the repository convention.

### 1.0.0

- Initial release. Read clinical FHIR (R4) data from Epic: Patient, Condition, Observation (labs, vitals, smoking history), Medication, MedicationRequest, Procedure, CarePlan, Goal, Immunization, DiagnosticReport, DocumentReference and Device.
- Appointment support: Get Appointment and polling triggers New Appointment, Updated Appointment, Cancelled Appointment.
- Get components for fetching a single resource by FHIR ID: Get Patient, Get Diagnostic Report, Get Procedure and Get Medication Request.
- Make Api Call component for arbitrary authorized FHIR requests.
