How to Integrate FaxLock with Epic EHR

By Zak B., Founder & CEO

To integrate FaxLock with Epic EHR, developers must use the FaxLock REST API to send an authenticated POST request containing the recipient's fax number and a Base64-encoded PDF. This automated workflow replaces manual faxing, ensuring HIPAA-compliant, encrypted document delivery directly from the patient record.

Why Integrate FaxLock with Epic?

Healthcare providers using Epic often need to send patient records, referrals, and prescriptions to external clinics via fax. Manual faxing creates bottlenecks and security risks. By integrating FaxLock, you can automate this delivery directly from Epic, ensuring the data is encrypted in transit and at rest.

How Does the API Integration Work?

The integration requires a server-side script (e.g., Node.js, Python, or C#) that listens for an event in Epic (like a document being finalized) and triggers a request to FaxLock. You will need to review the FaxLock API documentation to understand the authentication and payload structure.

Step-by-Step Integration Guide

1. Generate API Keys

Log in to your FaxLock dashboard and navigate to the Developer settings. Generate a new Bearer Token API key. Store this securely in your Epic environment variables.

2. Configure Epic Webhooks

Set up an outbound webhook or interface in Epic that triggers your integration script when a fax needs to be sent.

3. Map Patient Data

Ensure your script maps the required fields. Here is an example cURL request:

curl -X POST https://api.faxlock.com/v1/fax/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+15550100001",
    "from": "+15550100002",
    "fileName": "patient_record.pdf",
    "fileData": "JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoKPDwvTGVuZ3RoIDMgMCBSL0ZpbHRlci9GbGF0ZURlY29kZT4+CnN0cmVhbQp4nDPQM1Qo5ypUMFAwALJMLU31jBQsTAz1LBSKUrnCtRTyuUK5kFJmCkYWaZ",
    "webhookUrl": "https://your-epic-server.com/webhooks/fax-status"
  }'

4. Test Delivery

Send a test document through your Epic staging environment. Monitor the webhook callback from FaxLock to confirm the transmission was successful.

Frequently Asked Questions

Does FaxLock offer a native Epic connector?

FaxLock does not offer a native plugin for Epic, but provides a fully documented REST API that allows developers to build a custom integration tailored to their specific EHR workflows.

Ready to automate your faxing?

Get your API key today and start integrating.

Get Started