Epic (FHIR)

🚀 Quickstart

Connect to Epic with Nango and see data flow in a few minutes. Epic uses the SMART Backend Services flow — a machine-to-machine, JWT-signed authentication, with no end-user OAuth redirect.

Create the integration

In Nango (free signup), go to Integrations → Configure New Integration → Epic (FHIR). Register your Client ID, Key ID, Private Key, and Scope in the Settings tab — see the setup guide. These are entered once and reused automatically by every connection.

Connect a health system

Each connection represents one health system. Create it by supplying that health system’s Interconnect Server URL — see the connect guide for the exact fields.

Call the Epic FHIR API

Make your first request. Nango’s proxy base URL stops at /api, so include the FHIR version your app registered for (e.g. FHIR/R4) in the path yourself. Replace the placeholders with your API key (from Environment Settings), integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/FHIR/R4/Patient" \
  -H "Authorization: Bearer <NANGO-API-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>"

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ apiKey: '<NANGO-API-KEY>' });

const res = await nango.get({
    endpoint: '/FHIR/R4/Patient',
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

console.log(res.data);

Or fetch credentials with the Node SDK or API.✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.

📚 Epic (FHIR) integration guides

Nango-maintained guides for common use cases.

How to register your own Epic app
Register with Epic’s App Market, generate a key pair, host your JWKS file, and obtain your Client ID
How to connect a health system to Epic
Create a connection for a health system once your app is registered and approved

Official docs: Epic on FHIR — Backend Systems

🧩 Pre-built syncs & actions for Epic (FHIR)

Enable them in your dashboard. Extend and customize to fit your needs. No pre-built syncs or actions available yet.

Not seeing the integration you need? Build your own independently.

Overview

900+ APIs & Integrations

🚀 Quickstart

📚 Epic (FHIR) integration guides

🧩 Pre-built syncs & actions for Epic (FHIR)

​🚀 Quickstart

​📚 Epic (FHIR) integration guides

​🧩 Pre-built syncs & actions for Epic (FHIR)

🚀 Quickstart

📚 Epic (FHIR) integration guides

🧩 Pre-built syncs & actions for Epic (FHIR)