Provider Manual · Part IV

Practice setup — integrations

Wire Hero EMR to the outside world: referral/external providers, Stripe, SRFax, SMS, and EPCS for controlled prescribing.

11 sections~47 min read8 screenshots
IV
Part IV · continued

Practice setup — integrations

Wire Hero EMR to the outside world: referral/external providers, Stripe, SRFax, SMS, and EPCS for controlled prescribing.

4.6External providers

Connect every third-party integration from one hub

External Providers is Hero EMR's integration center. Every third-party connection — patient communication, clinical, billing, and fax — lives behind a single modal with a sidebar of tabs. Org admins manage the org-wide tabs; individual physicians can connect an SRFax account, which the whole practice sends from unless they keep it personal.

Patient communication

  • Email — the outbound sender (Active sender shows your Sender address, or Hero’s shared sender while the field is blank — “Leave blank to send from Hero’s shared sender.”) and inbound routing for patient replies.
  • SMS — provider-routed SMS for reminders and inbound replies. See §4.9.
  • Video conferencing — pick Zoom or Google Workspace as the active telehealth provider, then map each physician to a host. See Part III.
  • Phone agent — inbound phone routing via the Hero Phone Agent.

Clinical integrations

  • SureScripts — platform e-prescribing status and physician directory.
  • RadNet Connect — credentials for the RadNet ordering portal.
  • Labs — Quest and Labcorp connections, enabled lab compendiums, and the paper requisition form. See Labs: Quest & Labcorp.
  • Imaging visibility — which imaging providers show up at encounter completion.
  • Fullscript — supplement recommendations and Fullscript Labs through each clinician’s Fullscript account.
  • Calendar Sync — the clinician's own Google or Outlook calendar link. See §4.11.
  • Headway — for practices whose clinicians see clients through Headway; appears once the Headway feature is turned on. See §4.26.

Billing & payments

  • Stripe — Stripe Connect onboarding for patient payments. See §4.7.
  • Square — Square seller connection for portal payments.
  • Office Ally SFTP — SFTP credentials for EDI claim transport (claim batches, acknowledgements, and ERAs). Office Ally no longer checks eligibility, so there is no separate Office Ally login tab; eligibility runs through Stedi. A practice that hasn’t saved its own login reads Connected with “Uses Hero’s shared Office Ally login until your practice saves its own.”
  • Availity SFTP — SFTP credentials and EDI identifiers for Availity transport.
  • Stedi — clearinghouse provider records, payer enrollments, and readiness. Its Settings choose how claims use Stedi in one Claims select — Off — Stedi doesn’t send claims, A biller sends claims through Stedi (nothing automatic), Stedi sends ready claims; the rest go to your other clearinghouse, or Stedi sends ready claims; nothing else sends them — and a Right now: line states the practice’s actual claims route. With the Eligibility switch on, the Eligibility select is Stedi checks eligibility (the default) or Manual (no automated eligibility). Claim files and the daily batch for everything else are set in Billing → Claim Submission. Billing NPI by payer applies only to claims sent through Stedi.
  • Optum — Optum clearinghouse eligibility, claim status, and readiness.

Fax

  • Hero Fax — your Hero-managed practice fax number. See Get a dedicated Hero Fax number.
  • SRFax — an SRFax account for inbound and outbound fax, shared with the practice unless the person who connected it keeps it personal. See §4.8.
  1. Open Admin > External Providers. The modal opens on the tab you used last (a deep link or a button that names a tab opens that tab instead). Tabs are grouped in the left sidebar by category.
  2. Pick a tab. Each tab is self-contained — credentials, configuration, and a Verify/Test button. Status badges (Active, Disabled, Needs number, Not configured) tell you what's still missing. The claim channels (Office Ally SFTP, Availity SFTP) use the same words everywhere in Hero — Connected, Not connected, Needs attention, Turned off, or Manual billing only — so External Providers and Billing → Claim Submission never disagree.
  3. Refresh after external changes. If you change settings at the provider (e.g. add a new Office Ally payer), click Refresh in Hero to re-pull status.
Admin · External Providers modal grouped into Patient Communication, Clinical Integrations, Billing & Payments, and Personal sections with the Email tab open
The sidebar is grouped by category. Every integration lives here — there is no separate per-feature settings page. (This picture predates the Fax group, which now holds Hero Fax and SRFax.)
Screen updated since this picture: the help under Sender address now reads “Must use @{domain} or a subdomain. Leave blank to send from Hero’s shared sender.” (was “Blank = server default.”), and a blank sender shows as Active sender: Hero’s shared sender.
Bookmarkable tabs: Each tab supports a deep link via the ?externalProvider=<tab> query string (e.g. ?externalProvider=stripe). Useful when sending a teammate to a specific integration. The older ?externalProvider=zoom link still works — it now lands on Video conferencing.
Looking for PDMP? It is not an External Providers tab. Signup guidance and per-state controlled-substance settings are on the PDMP tab inside Admin > EPCS Enrollment & Access — see §4.10. Hero support configures approved connection credentials after enrollment; this tab has no credential-entry field.

Stedi account setup and enrollment follow-up

When Hero enables self-setup, Admin → External Providers → Stedi offers Set up Stedi account under Your Stedi account. Sign in or create the practice’s account on Stedi, approve access, and return to Hero. This connection does not itself change claims routing or approve payer enrollments. Ask Hero support if the setup card is absent.

Use Practice Setup → Open enrollment tracker to follow payer tasks and statuses. Its Received ERAs tab provides remittance PDFs during transition. The Stedi integration also includes Default Medicare payer for choosing the Part B payer preselected on scanned Original Medicare cards. See Stedi setup & ERAs for the workflow and required access.

4.6a“API key needed”

“API key needed” on a connection: what it means

If Admin → External Providers shows the badge API key needed on the Stedi tab, the Stedi claims and eligibility connection has not been set up on Hero’s side yet. There is no API key for the practice to type in; contact Hero support (F9 or support@heroemr.com) and the badge changes once Hero has connected it.

Apps that read your patients’ records do not use an API key either: register the app in Admin → Apps & API and give its developer the Client ID and, if it uses one, the Client secret (Register an app).

4.7Stripe & billing

Connect Stripe and set up billing for card payments, subscriptions, and balances

Stripe is the default payment processor for patient-facing card payments — copays collected at the front desk, cash-pay services, recurring memberships, balances posted from Billing, and card-on-file charges from the portal. Hero uses Stripe Connect, so each practice connects its own Stripe account. Payouts go directly to your bank; Hero never holds funds.

  1. Open Admin > External Providers and pick the Stripe tab (under Billing & payments). Setup runs as a three-step card wizard.
  2. Step 1 — Register your practice. Type your Legal entity name (e.g. Westside Family Medicine LLC) and click Create Stripe Account. The name is required; leaving it blank is refused with “Legal entity name is required before creating a Stripe account.” Nothing has left Hero yet at this point.
  3. Step 2 — Complete identity verification. Click Start Verification. This is the redirect into Stripe's hosted onboarding, which asks for business type, EIN, bank account, and a representative's SSN — the same onboarding any Stripe merchant does. Budget 5–10 minutes and have those details in hand. If Stripe has placed a hold, the reason prints on the card before the button.
  4. Step 3 — Go live. After you submit, the card reads “Verification submitted, awaiting Stripe approval.” Approval is usually minutes but can take days if Stripe pulls the account for manual review; click Refresh to re-check rather than restarting the wizard.
  5. Confirm Stripe Connect Active. The Stripe tab shows a green status badge with the connected account name (e.g. Dr. Romero's Practice) once Stripe has verified you.
  6. Open the Stripe Dashboard from Hero. Use the Open Stripe Dashboard button to review payouts, disputes, and refunds. Hero shows posted/refunded amounts in Billing, but Stripe is the source of truth for transaction-level detail.
  7. Disconnect to rotate. Use Disconnect if you need to attach a different Stripe account (e.g. merger, EIN change). Existing posted payments stay attributed to the original account; new charges land on the new one.
Stripe tab in External Providers showing the Stripe Connect Active green status banner with the connected account name and an Open Stripe Dashboard button
The Stripe Connect Active banner is the green light for taking card payments. Until you see it, the front-desk card reader and portal payments stay disabled.
Know the fees before go-live: click How it works on the Stripe tab. The Fee Breakdown there lists a Hero EMR application fee alongside Stripe's 2.90% processing fee, both applying to connected-account card payments. The Hero fee percentage is set for your practice, so read it off that panel rather than assuming — and share it with whoever prices your cash-pay services. The same panel draws the Payment Flow as four numbered steps — Patient → Hero EMR → Stripe → Your Bank, joined by secure payment, funds transfer, and auto payout. While the tab is still checking your account, its status badge reads Checking….
Stripe vs. Square: Most practices use Stripe. Hero also supports Square under the Square tab for practices that already have a Square seller account and want to keep their existing in-person card readers. Pick one — they don't run in parallel.
Card readers: register offices for card payments in the Stripe settings, then use Billing → Card readers to register and manage front-desk smart readers. The Stripe panel also links to Manage card readers. The Bluetooth M2 reader remains paired in the kiosk iPad app, and kiosk payment settings remain under Admin → Kiosk → Payments. See Payments & card readers.

Set up the billing workflow after Stripe is active

Once the Stripe tab shows Stripe Connect Active, finish the billing configuration in Admin > Billing. Membership (DPC) and hybrid practices should publish their membership plans before inviting patients to enroll through the portal.

  1. Open Admin > Billing. The Billing Command Center opens on the Dashboard. Confirm the practice name and payment model at the top, then use the left sidebar for configuration.
  2. Set the Payment Model. Choose Insurance, Pure Cash, DPC (membership), or Hybrid Insurance + Cash. The switch dialog previews what changes before you confirm (see §5.1). Decide in Collections & Fees whether patients must keep a card on file.
  3. Price your services in the Service Menu. The Service Menu lists your visit types per provider — not products or plans. Give each its cash price, collection rule, and, in a DPC practice, its Membership coverage: Covered by membership or Cash only (members pay too) (see §5.3). There are no membership, enrollment-fee, or bundle items to add here.
  4. Create membership plans in Subscriptions. Each plan has a name, amount, billing interval (monthly or annual), an optional trial, and an optional plan group that pairs the monthly and annual versions; publish it to open enrollment. Plans aren’t attached to Service Menu items, and a membership starts when the patient completes enrollment. Enroll patients by texting, emailing, or copying the enrollment link (see §5.12).
  5. Set missed-appointment fees in Collections & Fees. No-show and late-cancellation fees come from the Missed Appointment Policy there (or a service’s own override) and land on the patient’s account when a visit is marked a no-show or cancelled late; CPT List Prices holds your price per billing code, not one-time fees.
  6. Use Payments for verification. Post a small test charge or refund, then confirm it appears in Hero and in the Stripe Dashboard. Stripe remains the transaction-level source of truth for payouts, disputes, and refunds.
  7. Leave claims setup for insurance work. Only configure Claim Submission, Office Ally, Availity, Stedi, and payer enrollment when the practice is ready to submit insurance claims. A membership launch can start with Stripe, Service Menu, Subscriptions, and Payments first.
Billing Command Center dashboard with operations tabs and configuration tabs for Payment Model, Claim Submission, Collections and Fees, Service Menu, Subscriptions, and Charge Fees
The Billing Command Center keeps payment operations and configuration together. Membership practices start in Payment Model, Service Menu, and Subscriptions.
Screen updated since this picture: the sidebar now reads CPT List Prices (was Charge Fees), and Subscriptions sits under Programs.
Billing Command Center Payments tab showing manual entry, ERA upload, recent payment activity, posted card payments, and refund actions
Use the Payments tab to verify card payments and refunds after Stripe is connected. Posted payments should also be visible in the Stripe Dashboard.
Screen updated since this picture: the empty queue now reads Unposted Remittances — “Nothing is waiting — every remittance Hero received has posted.” — and a Post EOB button sits beside Manual Entry.
4.8SRFax

Connect an SRFax account for your practice

Hero supports SRFax accounts and a practice-wide Hero Fax number. Only one fax service can be active for a practice at a time. An administrator must pause Hero Fax before anyone connects SRFax; all connected SRFax accounts must be disconnected before setting up Hero Fax.

A connected SRFax account serves the whole practice. Anyone without an SRFax account of their own sends faxes, and sees their delivery status, through the practice’s shared account. Someone who connects their own account always sends from it. Accounts that were already connected became shared automatically; the person who connected one can make it personal (step 3).

  1. Open your SRFax settings. Go to Admin → External Providers → SRFax. Administrators find it in the Fax group. A physician with access to personal integrations sees their own SRFax settings. If you have no account of your own, the tab tells you which one you already send from: “You send faxes from the practice’s fax account (<number>), connected by <name>. Connect your own account only if your faxes should come from a different line.”
  2. Enter the required connection details. In Credentials, supply Access ID, API key, Fax number, and Sender email. The fax number accepts ordinary phone-number formatting. Sender email is required for delivery confirmations.
  3. Choose who can send from it. Let everyone in the practice send faxes from this account is ticked by default. Untick it to keep the account personal (“Only you can send from this account.”); a personal account is never used for anyone else. Once connected, the box saves as soon as you change it, without re-entering the password. Incoming faxes are not affected: they arrive in the practice’s Faxes inbox either way.
  4. Use Verify & save. Hero checks the credentials. Saving also updates the fax number on file; review any prompt to replace an existing number before confirming.
  5. Test sending and receiving. Send a non-patient test document to a known fax destination and confirm its delivery and receipt. See Send fax and the fax inbox.
  6. Disconnect before changing credentials. Saved fields are locked. Use Disconnect (Hero warns you if the practice also sends from this account), enter the replacement details, then verify and save again. An older connection without a sender email may show a fallback address or blocked sends; reconnect with a sender email to correct it.

If Hero Fax is active appears, a saved SRFax account is marked Inactive and its fields are disabled. Keeping old credentials does not make SRFax the active service.

If more than one account is shared, Hero always uses the same one: the oldest that verified without an error. An account stops serving the practice when the person who connected it is no longer an active member of the practice.

4.8aEmail: template & inbound

Email templates and inbound email: brand patient emails and receive patients’ replies

The practice’s email setup is in Admin → External Providers → Email (“Outbound sender, inbound routing, and auto-replies for patient email.”). It has three parts: the sender address, the Email template that brands automated emails, and Inbound routing for emails patients send to the practice.

Set the sender

Under Outbound sender, the Sender address is “the address patients see in the From header of email your team sends”. It must use the practice’s allowed domain shown as Allowed domain.

Hero sets up your domain to send email before you choose a sender: we add its email records when we set up your domain. If email isn’t set up yet, contact Hero support instead of entering an address. Hero refuses a sender on a domain that isn’t set up (“… isn’t set up to send email yet … Nothing was saved.”), because patients would get none of the practice’s email from it, including portal invitations and sign-up codes. Once a sender is saved, Sending shows Ready, or Not set up yet with a warning.

Portal invitations go out only from the practice’s own sender. With Sender address blank, staff can still text an invitation or show its QR code.

Change the email template

Email template sets the branding for automated patient emails: reminders, confirmations, follow-ups and registration. It changes the look of the emails, not their wording.

  1. Pick the colors: Header background, Header text and Buttons & links (hex colors such as #0f172a).
  2. Turn on Show practice logo to put your logo in the header. Upload the logo in Practice Info first.
  3. Fill in Signature (for example The Team at Your Practice) and any Extra footer lines, such as a language line or phone number.
  4. Check the Preview, which can show an appointment reminder, an appointment confirmation or a follow-up request, then click Save template. Reset to default returns to the standard Hero design.

Advanced: Custom HTML wrapper (advanced) replaces the whole layout with your own HTML; it must contain the {{content}} token where the message goes. When the reminders go out is set in Admin → Scheduling → Patient Notifications (Reminders).

Set up inbound email

  1. Under Inbound routing, turn on Enable inbound routing (“Route replies and incoming emails to matched physicians.”). The sender address must be set first.
  2. Choose the practice inbox address. Leave Derive org inbox from sender address on to use the sender’s domain, or turn it off and enter a Custom org inbox (for example replies@yourclinic.com). Org inbox shows the address in use and Physician direct shows the form of each physician’s own address.
  3. Decide on unknown senders. Under Unmatched senders, Auto-reply when sender doesn’t match a patient sends a short reply when an email from an unknown address is routed to Inquiries; it needs your Practice website / contact URL and an Auto-reply message.
  4. Click Save (Save & test when a Test recipient is filled in). Readiness & last errors shows Ready or Needs attention with the reason.

Emails to a physician’s address go straight to their Inbox. Replies to the practice address go to the physician who last saw, or is next scheduled to see, the patient.

4.9SMS messaging

Turn on SMS for reminders and patient replies

SMS powers appointment reminders, waitlist notifications, and two-way patient threads in the Inbox. The SMS tab in External Providers picks the carrier and the number SMS comes from, and holds the optional auto-replies and FAQ responder that fire on inbound texts. Configure SMS once at the org level; Scheduling > Patient notifications controls who receives what.

  1. Open Admin > External Providers > SMS. If SMS hasn't been set up, the tab header shows Not configured.
  2. Choose the carrier. The Provider card offers Telnyx (“Preferred for new HIPAA-oriented SMS and SIP numbers”) and Twilio (“Fallback for existing Twilio-routed numbers”). Pick Telnyx unless you are keeping a number that already routes through Twilio. Your choice renames the option below and, on Telnyx, adds a required Telnyx Messaging Profile ID field.
  3. Pick a phone-number source. Three options on the card:
    • Custom Telnyx number / Custom Twilio number — the label follows the carrier you picked. Type an E.164 number (e.g. +15551234567) provisioned on that carrier.
    • Organization phone — reuse the org phone from Practice Info.
    • Phone agent number — share the same number as the Hero Phone Agent (only if the agent is enabled and configured).
  4. Set Inbound auto-replies (optional). Three fields — No patient match, Multiple patient matches, and Matched and routed — cover the three ways an inbound text can land. All three start empty: the greyed-out sentence in each box is placeholder text showing the shape of a good reply. A blank Matched and routed field means Hero sends nothing once a text reaches your Inbox. A blank No patient match field means Hero texts back asking the sender to use your patient portal (with its link), unless those texts go to your Inbox (next step). A blank Multiple patient matches field sends your No patient match reply instead, or, if that is blank too, Hero’s reply explaining that the number is on more than one patient’s chart and pointing them to the patient portal. A patient whose chart matches but who has no portal account gets the same portal reply, unless your practice texted them a portal invitation in the 14 days before (next step). Hero sends one of these replies to a number at most once a day, and never to a number that texted STOP or to a short code. Write your own wording if you want different replies, then click Save auto-replies at the bottom of the card. That button saves only these three replies, and the FAQ’s own Save button never changes them. When a number is on more than one chart (a family phone, a test chart), Hero still files the text on one chart when it can tell which: the chart your practice texted at that number in the 72 hours before, otherwise the one chart whose patient-portal account signs in with that number. Website booking holds are ignored when a real chart has the number. A reply counts as an appointment confirmation or check-in only when the whole text is short, such as Yes, Yes please, Confirm, or Here; a longer text that happens to start with “Yes” goes to your Inbox like any other message.
  5. Decide where texts that can't be filed on a chart go. In the Texts that can’t be filed on a chart card, tick Show texts that can’t be filed on a chart in the Inbox and click Save Inbox setting. Texts from numbers that aren’t on a chart, are on more than one chart, or belong to a patient without a portal account then go to Inbox > Inquiries, marked as a text. Your reply there is sent as a text from the number they texted. The setting is off by default; while it is off, Hero texts back asking them to use the patient portal. A number on more than one chart always gets a reply, so the sender knows why. One kind of text goes to Inquiries whether the setting is on or off (the card says “Replies from a patient texted a portal invitation in the last 14 days always go to Inquiries”): a text from a patient without a portal account whose chart was texted a portal invitation in the 14 days before it arrived, such as a weekly portal invitation, an invitation sent from their chart, or an Invite patients to the portal text. They can’t get into the portal they were just invited to (for example, their email has changed), so Hero never sends them the portal reply. They get your Matched and routed reply if you wrote one, otherwise nothing until someone on your team answers in Inquiries. An invitation that went only by email doesn’t count.
  6. Decide whether to take texts from patients at all. Back in the Inbound auto-replies card, Don’t accept texts from patients — reply with a link to the app or portal is off by default. When it is on, a text from a number on one patient’s chart doesn’t reach your Inbox. Hero keeps the text on record and texts the patient back with the reply you write under Reply to patient texts, or, if you leave that blank, Hero’s: “{Practice} doesn’t accept text messages. For an emergency, call 911. Otherwise, please message us in the My Hero app or the patient portal: {link}”. Click Save auto-replies.
    • One reply per conversation per window. A patient who keeps texting gets this reply once in the window set under Matched and routed (Send the “Matched and routed” reply at most once every … hours, 1 to 168, 24 by default). Their later texts in that window are kept on record without another reply. While the setting is on, patients get this reply instead of your Matched and routed reply or a FAQ answer.
    • What still works as before: STOP, START and HELP; replies to appointment reminders, confirmations such as Yes or Y, and check-in replies such as Here or C; an URGENT text when your practice lets patients reply URGENT (it still reaches the Inbox marked urgent with its alert, and the patient gets the urgent confirmation followed by this reply); texts from numbers on no chart or on several charts (the steps above); and a reply from a patient without a portal account who was texted a portal invitation in the last 14 days, which still goes to Inquiries.
    • Never lost silently. If Hero can’t text the patient back (for example, the number texted STOP, or the practice’s texts to patients are still off before go-live), the text reaches your Inbox as it would without this setting.
  7. Consider the FAQ auto-responder. Further down, Enable FAQ auto-responder lets Hero text back answers to common, non-clinical questions — hours, address, appointment logistics — before they reach the Inbox. Add each pair with Add FAQ (Question / topic plus the Answer that gets texted), tick Active per entry, and click Save FAQ settings. Only a confident, non-clinical match is answered; anything uncertain or clinical falls through to the Inbox untouched.
  8. Click Verify number & configure webhook. Hero confirms the number is reachable, registers an inbound SMS webhook with the carrier, and flips the status to Active. Once verified, the number fields lock and the button becomes Save settings; use Disconnect to change numbers.
  9. Toggle Enable organization SMS. The master switch. Patients won't receive SMS at all until this is on, regardless of per-physician reminder policies.
  10. Test from a patient chart. Open any patient with a verified mobile, send a test message from the Inbox, and confirm both delivery and inbound reply routing.
  11. Run the STOP drill before go-live. Expand Test unsubscribe webhook, enter a phone you control, click Send test, reply STOP from that phone, then click Verify unsubscribe. The summary should flip from “Waiting for verification” to “STOP received.” If it doesn't, inbound webhooks are not reaching Hero and opt-outs will be silently ignored — a carrier-compliance problem, not a cosmetic one. The panel only appears once the number is verified.
Organization SMS tab with a Provider card offering Telnyx and Twilio, Custom number, Organization phone, and Phone agent number options, an Inbound auto-replies card, and a Verify number & configure webhook button
Pick the carrier, then the number source, then verify. Auto-replies are optional and blank by default; reminder cadence still comes from Scheduling.
10DLC and A2P registration: US carriers require business SMS senders to register their brand and campaign (10DLC). Hero handles the technical wiring, but you'll need to provide your EIN and a sample message during onboarding. Expect 1–2 business days for approval before SMS goes live.
4.10EPCS enrollment

Enroll physicians for controlled-substance e-prescribing

EPCS (Electronic Prescriptions for Controlled Substances) is the DEA-regulated workflow for prescribing Schedule II–V drugs electronically. Each prescribing physician enrolls separately: an admin creates the request and records identity proofing, a second admin countersigns it, and the physician then binds a signing device by registering a passkey. Once the enrollment reaches Active, that bound device is the physician's second factor when they sign controlled prescriptions inside Hero. The EPCS modal also configures PDMP (state-mandated controlled-substance database) checks per state.

  1. Open Admin > EPCS Enrollment & Access. The modal opens to the Enrollments tab with a list of in-flight and completed enrollments.
  2. Click + New Enrollment. Pick a physician (must already exist in Physician Management with a valid DEA) and confirm the DEA Number — Hero prefills it from the physician's identifiers and refuses a value that disagrees with the record on file.
  3. Record the Identity Proofing result. The dropdown offers Pending, Verified, or Failed. Identity proofing itself happens outside Hero; this field is where the admin records the outcome for the audit trail, so don't set it to Verified until you have the evidence in hand.
  4. Set the Privilege Template. Full Prescriber enables all five EPCS privilege flags; Enter Only allows draft entry with no signing or transmitting rights; Custom lets you tick the Privilege Matrix by hand. The five flags are Enter (create controlled draft orders), Alter (modify existing drafts), Ready (mark ready for sign), Sign (apply the EPCS signature), and Transmit (send to the pharmacy) — so this choice decides whether the clinician can only draft controlled orders or can actually sign and send them. At least one flag is required.
  5. Get a second admin to countersign. The new request lands as Requested. One admin clicks Approve to record the first approval, which moves it to Pending 2nd Approval; a different admin then gives the second approval with Second Sign. Only after that does the enrollment become Waiting Device. Revocation follows the same two-person path — Revoke records the first approval, and a different admin must complete Second Sign Revoke before access is actually removed.
  6. Approve the second sign on a phone. Second Sign opens Second Sign Approval (Second Sign Revocation for a revocation): “A second admin approves this access on their phone, in the Hero app, with the passkey on their EPCS device.” Choose the approver under Who’s approving? and click Send to phone. The approver opens the Hero notification (or Hero app → EPCS) and approves with the passkey on their EPCS device; the request expires in 10 minutes, and Send again sends a new one. When it lands: Second Approval Recorded, “Logical access is now approved. Issue a device invite next.” Admins who can’t receive it are greyed out with No EPCS device set up in the Hero app or Needs the latest Hero app; the first approver and the person who requested the enrollment can’t be chosen. Use a passkey on this computer instead keeps the old way: a different admin confirms with a passkey saved on that computer, which works only if one of the two approvers has already confirmed with their EPCS device.
  7. Issue the device invite. On a Waiting Device row, click Issue Invite. Hero generates a one-time invite token with an expiry plus an app deep link, and offers Copy Token and Copy Link. Send the link to the physician through a channel you trust — it is what binds their signing device.
  8. Have the physician bind their device. Opening the link on their phone launches Hero EMR, where they sign in and register a passkey (Face ID / Touch ID / device unlock) against the invite. The bound device then shows in the Devices column as iPhone/iPad, Android Device, Web Browser, or Passkey Device, and the enrollment flips to Active. One bound device is enough — the status is Waiting Device, singular. If a phone is lost or replaced, use Lost Phone to revoke the active devices and issue a fresh invite in one step.
  9. Confirm with Test Device. On an active row, this sends a fictitious approval request to the prescriber's phone so you can confirm the approve/deny prompt works before a real controlled prescription depends on it. The result stays on the row rather than vanishing with a toast.
  10. Switch to Monitoring for active enrollments. Shows recent EPCS signing activity per physician — useful when compliance or DEA audits ask for a log.
  11. Configure PDMP per state. Each state mandates which substances trigger a PDMP check and how recently. The PDMP tab lets you flip rules (e.g. CA controlled substances, KY HB1, OH OARRS) on or off, and enforce Require PDMP check for controlled prescriptions or Require reason override when a check is skipped.
  12. Review Security Alerts. Hero surfaces unusual signing events (new device, new geo, off-hours) for follow-up. Investigate any alert flagged in red.
EPCS Enrollment modal with sidebar tabs Enrollments, Monitoring, PDMP, and Security Alerts; main pane shows the enrollments table with physician, DEA, status, devices, and requested columns
EPCS is per physician. The sidebar moves between enrollment progress, signing monitoring, per-state PDMP rules, and security alerts.
You need two admins. EPCS logical access is under two-person control, and Hero enforces it: the admin who records the first approval cannot also complete the second sign, for granting or revoking EPCS access. A single-admin practice will get an enrollment stuck at Pending 2nd Approval with no way forward. Create the second admin account before you start EPCS enrollment. The second signer completes their step with a passkey; if the first approver did not already verify with an approved EPCS hard token, the second signer must use one — meaning your second admin should themselves be EPCS-enrolled.
Plan the timing: Identity proofing, both admin approvals, and the physician binding their device typically takes 30–60 minutes of hands-on time, but it is spread across three people and the invite token expires. Line up the second admin and get the physician's phone in front of them before you issue the invite, and start EPCS enrollment a week or two before go-live rather than on day one.

PDMP signup and EHR connection

Open Admin > EPCS Enrollment & Access > PDMP for PDMP settings and signup instructions. Each prescriber needs an active state PDMP account, and the practice needs separate approval for EHR integration. Completing EPCS enrollment does not enroll you in the PDMP.

Enable PDMP does not activate a connection. The toggle saves your practice setting. Hero support handles the approved Bamboo / PMP Gateway connection credentials; there is no credential-entry field in this tab. If the status remains Not configured, contact Hero support to coordinate onboarding and configuration. Check config checks configuration status; it does not submit an enrollment application or verify a live patient query.

Illinois: register for ILPMP and request PMPnow integration

  1. Register the prescriber. Open ILPMP registration and select Prescriber. Complete the application with your name, practice address, DEA number, Illinois license information, and business phone. If you already have an account, sign in or recover it through ILPMP.
  2. Request your practice connection. Email DHS.DBHR.PMPnow@illinois.gov to request PMPnow integration. Identify Hero EMR as your EHR and ask the team to confirm the available integration route. Contact the team for changes to an existing EHR connection too.
  3. Complete Illinois onboarding. Attend the required educational session, complete the Memorandum of Understanding (MOU), and submit the facility and provider template supplied by the PMPnow team. Integration can proceed after the required materials are approved.
  4. Coordinate activation with Hero. Contact Hero support with the approval or onboarding reference so we can coordinate connection setup and validation. Share connection secrets only through a secure channel arranged with support. Use the ILPMP website for direct access while integration is pending.

State approval and integration availability must be confirmed before activation. For other states, follow your state PDMP’s enrollment and EHR integration process with Hero support.

Official Illinois instructions: PMPnow integration and ILPMP FAQs.

4.10bEPCS phone & backup codes

Link a prescriber’s phone for controlled prescriptions by QR code, and add an authenticator app or hardware token as a backup

Controlled prescriptions are approved on the prescriber’s linked phone. Once an administrator has approved a prescriber’s EPCS access (see EPCS enrollment), the phone can be linked with a QR code, and practices can allow a backup code from an authenticator app or a hardware token.

Link my phone (QR code)

EPCS phone setup by QR code is on by default (Admin → Additional Features). A prescriber whose access is approved but who has no phone linked yet sees Link my phone where Hero says they can’t sign controlled prescriptions yet, for example in order entry. Administrators see the same QR code on the device invite in Admin → EPCS Enrollment & Access once the prescriber’s verified phone is on file.

  1. Click Link my phone; a QR code appears.
  2. Scan it with the phone’s camera. “My Hero opens and texts a 6-digit code” to the prescriber’s verified phone.
  3. Enter that code on the phone, set up Face ID if asked, and the phone links by itself: “You can now approve controlled prescriptions on your phone.” If the code expired or was replaced, click New code.

Backup: an authenticator app or hardware token

When an administrator turns on EPCS authenticator tokens in Admin → Additional Features (off by default), a prescriber with a linked phone can add a backup way to sign. The phone stays the default.

  1. Click the + (Add an authenticator app or hardware token) next to the phone approval in the controlled-prescription signing window, or under EPCS signing in Sign-in & security.
  2. Choose Add an authenticator app or Add a hardware token, set it up with the QR code or key, name it so you can tell your tokens apart, and enter a current code from it. The linked phone approves the addition.
  3. At signing, the phone is still asked first. While the request waits, Use an authenticator code instead takes the Code from your authenticator and Your Hero password. Compounded prescriptions are always signed on the phone.

Administrators see each prescriber’s tokens in Admin → EPCS Enrollment & Access and can revoke them; revoking an enrollment revokes them too.

4.11Calendar sync

Sync your schedule with Google Calendar or Outlook

Calendar Sync links a clinician’s own Google Calendar or Outlook / Microsoft 365 account to Hero so the EMR schedule and their outside calendar stay aligned — outside commitments block time on the Hero schedule, and (optionally) Hero visits appear on the personal calendar. Unlike the other items on this page, Calendar Sync is per-clinician self-service: every clinician connects their own calendar from the toolbar Settings (gear) → Calendar Sync menu. Admins can also reach the same panel through Admin > External Providers, but there is no org-wide “connect everyone’s calendar” switch — each clinician authorizes their own account.

Two independent directions of sync are available, and they default differently:

Import (default ON)

Pulls busy events from the calendars you choose in your connected account and blocks that time on the Hero schedule. You can check several calendars of the same account, up to 10 (for example your primary calendar, a personal or shared calendar, and a pre-charting calendar), and busy time on any of them blocks your Hero availability. A meeting that appears on two checked calendars blocks once. Events you add yourself to your Hero EMR calendar also block your time; the appointments Hero exports there never do. Each blocked window is created as time off labeled with the outside event’s own title (plus its description when the two differ), so read the warning below before connecting a calendar that holds sensitive titles. Events you have marked Free are skipped entirely, and imported time never covers a patient already booked in Hero.

Export (default OFF)

Pushes your Hero scheduled visits into a dedicated Hero EMR calendar in your linked account (a calendar created before Hero’s rename may still be called SoaperEMR until the next sync renames it). This carries PHI, so turning it on requires acknowledging a PHI/BAA warning first.

Include full appointment details (PHI)

An optional export toggle. Off, exported events show busy time only. On, they add patient names and visit reasons to the events in your outside calendar.

  1. Open Calendar Sync. Click the toolbar Settings gear and choose Calendar Sync. (Admins can also open Admin > External Providers and pick the Calendar Sync tab.)
  2. Connect a provider. Each provider card — Google Calendar and Outlook / Microsoft 365 — has a Connect button that sends you through that provider’s OAuth consent screen. Sign in with the account you want to sync and approve the requested calendar access; you’re returned to Hero with the card now showing your connected account.
  3. Choose what syncs. On the connected card, Import busy times (block my availability) is on by default — and imported blocks carry the outside event’s title onto your Hero schedule, so review the warning below before you leave it on. Under Calendars to import from, check every calendar whose busy time should block your schedule (your primary calendar is listed first, with each calendar’s color). Each change is saved right away and applied by an immediate sync; unchecking a calendar removes the blocks it created on that sync. At least one calendar stays checked — turn import off to stop importing. Leave Export my appointments to this calendar off unless you want Hero visits on your outside calendar — turning it on opens a PHI/BAA confirmation you must acknowledge. If you enable export, decide whether to also turn on Include full appointment details (PHI); otherwise exported events stay busy-time only.
  4. Keep it in sync. Sync runs automatically in the background once connected. Click Sync now to force an immediate pass, or Refresh to re-read the current connection status. A Reconnect required badge means the authorization expired or was revoked at the provider — click Connect again to re-authorize. If one checked calendar can’t be read (it was deleted or is no longer shared with you), the others keep syncing: the card shows Last sync completed with issues naming that calendar, and its busy times already in Hero stay blocked until it can be read again or you uncheck it.
  5. Disconnect when needed. Click Disconnect to stop syncing and unlink the account. The confirmation warns that imported busy times will stop blocking your availability — those blocks are removed from the Hero schedule — and that exported appointments will no longer be updated. If you have ever exported, the same dialog offers a checkbox, Also delete exported appointments from <provider>, which removes the Hero EMR calendar and every appointment Hero put in it. This is your only chance to use it: disconnecting revokes the access Hero needs to clean up later, so anything you leave behind stays in that calendar permanently.
The toolbar Settings gear dropdown open with a Calendar Sync entry listed among the menu options
Calendar Sync is reached per clinician from the toolbar Settings gear — not from an org-wide admin switch.
Calendar Sync panel showing a banner that reads Calendar Sync is not enabled for this environment, with Google Calendar and Outlook / Microsoft 365 provider cards both marked Not configured
Until an administrator enables Calendar Sync and configures the OAuth credentials, the panel shows the not-enabled banner and both provider cards read Not configured — the current state on the demo environment.

Once OAuth is configured, the connected card replaces the Not configured state with your linked account name, the Import busy times (block my availability) toggle with its Calendars to import from checklist, the Export my appointments to this calendar / Include full appointment details (PHI) toggles, and the Sync now, Refresh, and Disconnect controls. Enabling export raises the PHI/BAA confirmation dialog described above before any visit data is pushed.

Import copies your event titles into Hero — it is not busy-time-only. For every busy event it finds, Hero creates a time-off block whose label is that event’s title, with the event description appended after a colon when the two differ (trimmed to 255 characters). A calendar entry reading “Oncology consult — Mrs. Alvarez” or “Marriage counseling” appears verbatim on your Hero schedule, where schedulers and admins who can see your time off can read it. Private or personal events are not filtered out. Before you connect a calendar that holds sensitive titles, mark those events Free — free/“show as available” events are skipped and never imported — or connect a calendar whose titles you are comfortable exposing to your practice.
Imported busy time is not padded by visit-type buffers. A visit type’s Buffer Time pads Hero appointments only, so a visit can be booked right up to the start or end of an imported event. Pre-charting time you want held in Hero itself belongs in a weekly template (Type Administrative, Templates), not only on an outside calendar. For the calendar checklist on its own, see Import from several calendars.
Do not: enable Export my appointments to this calendar to a personal Gmail or Outlook.com account. Export pushes PHI out of Hero, so it is only appropriate for a Google Workspace or Microsoft 365 account covered by a signed BAA. Personal consumer accounts are not BAA-eligible and must never be used for export. Import sends nothing out of Hero, but it does pull outside event titles in — see the warning above.
Admin prerequisite: Calendar Sync only works after an administrator enables it for the environment and configures the Google / Microsoft OAuth credentials. Until then the panel shows “Calendar Sync is not enabled for this environment” and each provider card reads Not configured, so clinicians can’t connect yet. See §4.6 External Providers for where these integrations are managed.
4.25Labs

Connect Quest and Labcorp, and choose the labs clinicians can order

Admin > External Providers > Labs holds the practice’s lab connections: “Quest and Labcorp connections, enabled lab compendiums, and the paper requisition form.” Practice administrators manage it.

Until a practice connects a lab, Quest is on by default but has nothing to search, so lab searches in Search Orders say “No lab is connected for this practice yet. An admin can connect one in Admin → External Providers → Labs.” When the practice uses outside lab orders, it adds “Until then, use Order from an outside lab.” A practice with a paper requisition sees “Ordering from the practice’s paper requisition — no electronic lab is connected.” instead.

Connect Quest (set up the Quest interface): add Hero’s user

To connect Hero with Quest, the recommended way is to add Hero’s own user to your practice’s Quest Quanum account. Hero then signs in to Quest Quanum with that user to send your Quest orders and bring back your results.

  1. Copy Hero’s address. The Quest Diagnostics card shows Hero’s Quest Quanum user: an email address Hero made for your practice, with Copy.
  2. Add it in Quest Quanum. Sign in to Quest Quanum as an administrator for your practice and add a new user with that address. Give it a clinical role (not Non-Clinical Office Staff) with access to all of your practice’s Quest accounts and providers; non-clinical users cannot place orders or see results.
  3. Request order and result review privileges for that user. Without them, Hero cannot send your Quest orders or bring back your results.
  4. Click I’ve added this user. “Thanks. Hero will finish connecting Quest.” You never share a password with Hero. The badge moves from Not set up to Waiting for Hero, then Connected, and then the Quest compendium can be enabled (below).

Or connect Quest with your practice’s own Quest login

If Quest won’t accept Hero’s user, connect with a Quest Quanum login your practice already has. Open Use your practice’s own Quest login on the same card: “Use a login with a clinical role and order and result review privileges.”

  1. Enter Quest username and Quest password.
  2. Click Test and save. Hero signs in to Quest Quanum with it first. When it works: “Quest is connected with your practice’s login.” and the badge reads Connected with your practice’s own login. When Quest refuses it, the card says why (for example “Quest did not accept that login. Check it and try again.”).

Hero encrypts the password and never shows it again. If someone changes that password in Quest Quanum, enter the new one under Update your practice’s Quest login, which opens by itself when Quest starts rejecting the login. Saving a login there replaces Hero’s user if Hero’s user was connected; Use Hero’s user instead shows the steps to switch the other way. Both ways are supported.

If Quest refuses the sign-in, the card says Quest is rejecting the saved sign-in (or that the password expired): “Quest orders cannot send until this is fixed.” With Hero’s user, check in Quest Quanum that the user is still active with a clinical role and order and result review privileges, then click I’ve checked this user. With your own login, enter the current password under Update your practice’s Quest login. Disconnect takes Quest off (“Quest orders stop sending until Quest is connected again”). For results, including Quest results ordered outside Hero, see Lab results from Quest and Labcorp.

Specimen collection on the Quest card says where your Quest specimens are drawn: Patients go to a Quest location (the default: “Signed Quest orders go to Quest as Patient Service Center orders; the patient goes to a Quest location.”) or We draw in our office: “Signed Quest orders wait in Labs until staff plan the draw day. Hero then files a Quest scheduled order, saves Quest’s requisition to print the day before, and releases the order the morning of the draw.” Orders signed before a change keep the way they were sent. See Quest orders drawn in the office.

Labcorp

The Labcorp card (“Order Labcorp tests from the chart with your practice’s Labcorp account.”) needs Hero to turn Labcorp ordering on for your practice; until then it says “Labcorp ordering is turned off on this server. Hero support turns it on.” and its fields are greyed out.

  1. Enter the account. Labcorp account number (the 8 digits from your Labcorp paperwork), an optional Account name, and the Default bill method: Patient bill (the default), Private insurance, Medicare, Medicaid, or Bill to practice (which needs a client-bill account at Labcorp). Click Save: “Labcorp account saved.” Hero doesn’t need a Labcorp login for this.
  2. Choose how orders go out. Send orders: Print a Hero requisition, or Electronic via Labcorp Link once Hero has connected Labcorp Link for your account. For Labcorp Link, the card shows Hero’s Labcorp Link user: add it in Labcorp Link as an administrator with access to your account number, request order and result review privileges for it, then click I’ve added this user.
  3. Choose where specimens are drawn. Specimen collection: Patients go to a Labcorp location (“Signed orders tell the patient to visit a Labcorp Patient Service Center.”) or We draw in our office. With in-office draws and electronic orders, “Signed orders wait in Labs until staff record the draw; Labcorp gets them with the collection time.” (see Record an in-office Labcorp draw). With printed requisitions, “Hero requisitions print with blanks for the collection time and collector initials.”
  4. Turn the Labcorp tests on. Under Enabled lab compendiums, tick Labcorp and click Save lab visibility. Labcorp tests then appear in the order search (see Lab orders).

The status line under the badge says how orders and results work for your account, for example “Orders print as a Labcorp requisition the patient takes to a Labcorp Patient Service Center. Results arrive by fax as they do now.” Remove takes the account off (“Labcorp tests will no longer be offered when ordering labs. Labcorp orders already placed are not changed.”).

Enabled lab compendiums

Tick each lab whose tests clinicians may search, then Save lab visibility. Each row says whether it is ready to search and send, and why not when it isn’t (for example “Add your Labcorp account number in External providers > Labs > Labcorp.”). Quest is ticked until you change it, so a practice that has not connected a lab yet sees Needs attention: “None of the labs ticked under Enabled lab compendiums is connected yet, so clinicians can’t search or pick lab tests.” Clinicians’ lab searches then say “No lab is connected for this practice yet. An admin can connect one in Admin → External Providers → Labs.” If every lab is unticked, they say “No lab is turned on for this practice.” The same card has Only fill in a dictated lab when its name matches a test exactly, off by default: “Otherwise the lab stays in the note marked “Pick a test” and is not sent until someone chooses the test.” Turn it on if dictated labs too often land on a near-miss test.

Paper requisition templates in the same tab can add Labcorp tests by test number with Add from Labcorp, next to Add from Quest; this works without a Labcorp account.
4.25bLab results

Lab results from Quest and Labcorp: how they reach the chart, and older results

Once Quest or Labcorp is connected, Hero checks for new results by itself through the workday and files them into the patient’s chart and the ordering clinician’s Results inbox. You don’t need to check results in your Quest Quanum or Labcorp Link account: Hero signs in to Quest Quanum (with Hero’s user or your practice’s own login, see Labs: Quest & Labcorp) and to Labcorp Link for you. Both settings below are in Admin > External Providers > Labs.

Quest

  • Results for Quest tests ordered in Hero come back automatically; there is no switch.
  • Add Quest results for tests ordered outside Hero (off by default) also “Files results for tests ordered in another EHR, through Fullscript or in the Quest portal.” A result is added only when its ordering provider’s NPI belongs to your practice and the patient’s first name, last name and date of birth match exactly one chart; other results are not added.

Labcorp

Labcorp results are retrieved once Labcorp Link is connected; until then “they reach the chart by fax or upload.” Turn on Bring Labcorp results into the chart on the Labcorp card: “Labcorp results retrieval is on. New reports reach the chart at the next check.” Hero files each report with the official Labcorp report for Hero’s Labcorp orders, and for results that carry a patient id Hero knows (the Hero MRN or the previous system’s id) when the family name, first initial and date of birth agree. More switches appear once it is on:

  • Also file results for tests ordered outside Hero: files results that match no Hero order and no known patient id when exactly one chart matches the patient’s name and date of birth and the ordering clinician’s NPI is one of your clinicians.
  • Close printed Labcorp orders when their results arrive: marks an order placed on a printed Hero requisition completed (in progress for a preliminary report) when the report is for the same patient, the same Labcorp test and the same ordering clinician, collected within 120 days after the order. If two open orders could match, Hero closes neither.
  • Only notify me when a lab result is final (off by default): Labcorp often sends a preliminary report before the final one. With it on, an all-normal preliminary goes into the chart (held from the patient if your practice releases results after review) without an alert or a Results item, and the final report notifies you once. A preliminary with abnormal or critical values still notifies you right away unless you also turn on the next switch. A preliminary still waiting for its final is shown to you 48 hours after it arrived, or 12 hours before the patient hold would release it.
  • Wait for the final even when a preliminary has abnormal values (off by default; shown only while the switch above is on): a preliminary with abnormal values (high or low) also waits for its final report, so you get one alert per result instead of two. A critical value still notifies you right away, preliminary or not. Turn it off and an abnormal preliminary still waiting is shown to you within 15 minutes.

Under the switches, Last checked shows the latest check, or why results are paused. Results Hero could not file on its own show as Results to review with a count; click Review, choose the Clinician who reviews matched results, then Match to patient, Try again, or Dismiss (“It will not be added to any chart.”) for each.

Pull old Quest or Labcorp results into a chart

Hero does not import a patient’s old results on request. When Quest is first connected, Hero looks back about 30 days; Labcorp reports issued before you turned retrieval on are not retrieved. For older results, download the report from Quest Quanum or Labcorp Link and upload it to the patient’s chart (see Uploading files).

Need help? Email support@heroemr.com.